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Preface 


Purpose of This Guide 


This manual describes the use of DCL (Digital Command Language), 
System Utility Programs, and general programming information on 
RSTS/E. 


Terms Used in This Guide 
The following terms are used throughout this guide: 
Command Line 
The part of a command string you type on one line on your terminal. 


Command String 


A complete command, including the command name, parameters, and 
switches or qualifiers (Gif any). 


Default 


A built-in value that the system assumes when you do not supply a 
particular value. For example, when you do not supply a device name 
in a file specification, the system assumes the public disk structure. 
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Parameter 


Part of a command string that specifies what the command is acting 
on. For example, the COPY command acts on files, so its parameters 
are file specifications. 


Qualifier 


In DCL, part of a command string that modifies the command’s action 
in some way. For example, the PRINT command’s /COPIES qualifier 
lets you print several copies of a file. All qualifiers start with a slash 


(/). 
Switch 


A synonym for qualifier; that is, part of a command string that mod- 

ifies the command’s action in some way. For example, using the /DE 

switch in a PIP command causes PIP to delete the specified file. Like 
qualifiers, all switches start with a slash (/). 


This guide uses the term switch instead of qualifier when describing 
system utility programs and command environments other than DCL. 
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Conventions 


C ] 


Ctrl/x 


Indicates an optional part of a command. This does not apply to 
[p,pn] where the brackets ([ ]) are part of the required command 
syntax. 


Indicates a required choice of one item among two or more 
possibilities. 
Indicates a choice of one item among two or more possibilities. 


Indicates that you can repeat the preceding item in the command 
format. 


Indicates examples. 


Indicates that you can use a DCL qualifier over the DECnet 
computer network (if your system has DECnet/E). 


Represents the Ctrl key and another character, represented here 

by x. For example, enter Ctrl/U by holding down the Ctri key and 
pressing the key labeled U. RSTS echoes or displays the character — 
at your terminal as “U. 


Summary of Technical Changes for RSTS/E V10.0 
RSTS/E V10.0 is a major release of the RSTS/E PDP-11 operating 
system. This manual describes the following new features: 
e Extended logicals 
¢ Host initiated (Outbound) LAT 
¢ Command line editing and recall 
¢ Operator/Message Services (OMS) 
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Chapter 1 
System Information 


This chapter provides system information. Table i—1 lists the RSTS/E 


control characters and terminal keys. 


Table 1-1: Control Characters and Terminal Keys 


Key 
Ctrl/A or F14 


Ctrl/B or Up Arrow 


CtrV/C 


Ctrl/D or Left Arrow 


Function 


Toggles from overstrike editing mode to insert 
mode, or vice versa, while editing a command line. 
Effective only until a delimiter is entered, then the 
mode reverts back to the terminal setting. 


Recalls the previous command typed by the user 
at the current command level. When Ctrl/B or Up 
Arrow is entered, the current line, if any, is erased 
and the next previous command from the recall 
buffer is put in its place. The cursor is positioned 
at the end of the recalled command, regardless of 
the position of the cursor previous to the recall. 


Halts execution of the current command or program 
and usually returns control to the job keyboard 
monitor. (In some programs, Ctrl/C may return you 
to the program’s command level.) Ctrl/C echoes on 
the terminal as “C. You can lose data with Ctrl/C 
because it causes an immediate halt. 


Moves the cursor to the left or backwards one 
character position in the command line. If the 
cursor is already at the beginning of the command 
line, the key is ignored. 
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Table 1-1 (Cont.): Control Characters and Terminal Keys 


Key 


Ctrl/F or Right Arrow 


Ctrl/H, BACKSPACE, or 
F12 


CtrV/E 


Ctrl/I or TAB 


Ctrl/J, LINE FEED, or 
F13 


Ctrl/L or FORM FEED 


Ctrl/N or Down Arrow 


CtrV/O 
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Function 


Moves the cursor to the right or forward one char- 
acter position in the command line. If the cursor is 
already at the end of the command line, the key is 
ignored. 


Moves the cursor to the beginning of the command 
line. If the cursor is already at the beginning of the 
command line, the key is ignored. 


Moves the cursor to the end of the command line. 
If the cursor is already at the end of the command 
line, the key is ignored. 


Moves the cursor to the next tab stop on the ter- 
minal line. By default, tab stops are eight spaces 
apart (see the SET TERMINAL/TAB command). 


On terminals that do not support line editing, ends 
the current line. LINE FEED moves the cursor 

to the next line but does not return the cursor to 
the left side of the screen. On terminals that do 
support line editing, deletes the word to the left of 
the cursor. 


Sends a typed line to the system for processing 
and skips four lines on a video terminal. FORM 
FEED and Ctrl/L advance the paper to the top of 
the next page on hardcopy terminals (see the SET 
TERMINAL/FORM_FEED command). 


Performs a function similar to Ctrl/B or Up Arrow 
except it moves forward in the recall list, obtaining 
the next command entered. Requesting a forward 
recall when at the most recent entered command 
of the recall buffer results in erasing the current 
command line on the screen and no line is recalled. 


Stops and restarts terminal output while a program 
is running. Ctrl/O does not affect program exe- 
cution; however, the system discards all terminal 
output the program produces between the time you 
stop output and restart it again. Ctrl/O echoes on 
the terminal as “O. 


Table 1-1 (Cont.): Control Characters and Terminal Keys 


Key Function 
Ctr//Q Resumes terminal output suspended by Ctrl/S 


while a program is running. You can use Ctrl/Q 
only if the DCL TTSYNC (or STALL) characteristic 


is set for the terminal. 


Ctr/R Redisplays all characters you typed since the 
last time you terminated a line, as well as any 
characters you typed ahead that the system has not 
yet processed. 


CtrV/S Suspends terminal output while a program is run- 
ning. You can use Ctr//S only if the DCL TTSYNC 
(or STALL) characteristic is set for the terminal. 
When you use Ctri/S, the system saves all termi- 
nal output that the program produces instead of 
discarding it (as it does when you use Ctrl/O). 


Ctr/T Displays a one-line status report for your job. The 
report includes your job number, keyboard number, 
job state, current run-time system, and other 
information. 


Ctr/U Erases all characters from the beginning of the line 
to the cursor. The remaining characters are shifted 
to the beginning of the command line. Ctrl/U erases 
characters from the screen on terminals which 
support line editing. On multiline commands, 
deletes only the portion of the command from the 
cursor to the left margin. 


Ctrl/X Deletes all type-ahead including the current termi- 
nal line. Ctrl/X echoes as “X and moves the cursor 
to the next line. 


CtrV/Z Exits most RSTS/E system programs. Ctri/Z also 
signals the end of a terminal input file. 

Ctrl/[, ESCAPE, or Sends a typed line to the system for processing 

ALTMODE or starts an escape sequence if the terminal is set 


/ESCAPE_SEQUENCE. ESCAPE, ALTMODE, and 
Ctrl/[ echo on your terminal as a dollar sign ($). 


System Information 1-3 


Table 1-1 (Cont.): Control Characters and Terminal Keys 
Key Function 


DELETE or RUBOUT Erases the character to the left of the cursor. Any 
characters to the right of the cursor are shifted to 
the left. On hardcopy terminals, erased characters 
are displayed between backslashes. 


NO SCROLL Performs the same function as Ctrl/S and Ctrl/Q on 
the VT100, VT101, VT125, and other VT100-family 
terminals. The DCL SET TERMINAL/TTSYNC (or 
STALL) characteristic must be set for the terminal. 


HOLD SCREEN Performs the same function as NO SCROLL on the 
VT200 and VT300-family terminals. 
RETURN Sends a typed line or command to the system for 


processing. Pressing RETURN moves the cursor to 
the beginning of the next line. 


Files 


This section provides information on the file specification format, file 
types, file specification switches, and file protection codes. 


File Specification 


A file specification is the full name and location of a file. It has the 
format: 


node::device:[p,pn }filename.typ/switches 
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where: 


node:: 


device: 


[p,pn] 


filename 


typ 


/switches 


Specifies a node name on the DECnet network. The default 
node is your system. You can specify a node name only 
in certain DCL and DECnet/E commands. You use node 
names only if your system is part of a DECnet network. 


Specifies a physical or logical device name. The default 
device is the public disk structure. 


Specifies the directory on the device, identified by its 
project-programmer number (PPN). The default is your 
current account. You can include a dollar sign ($) in place 
of a PPN to indicate directory [1,2], which is the system 
library. You can include a percent sign (%) in place of a 
PPN to indicate directory [1,4]. You can include an amper- 
sand (&) in place of a PPN to indicate directory [1,5]. You 
can include a pound sign (#) in place of a PPN to indicate 
directory [your project number,0]. 


Specifies a one- to six-character file name. 


Specifies a one- to three-character file type. The default file 
type depends on the command or program you are using. 


Specifies one or more RSTS/E file specification switches: 
/PROTECTION, /CLUSTERSIZE, /FILESIZE, /POSITION, 
/RONLY, or /MODE. These switches specify the file protec- 
tion code, cluster size, and other values. 

You cannot use RSTS/E file specification switches in DCL 
except where specified as a valid qualifier in the command 
description. Instead, you use DCL commands and qualifiers 
to set these values. Note that (MODE and /POSITION 
switches have no DCL equivalent. 


The next three sections provide more detail on file types, file specifi- 
cation switches, and file protection codes. Table 1—2 lists RSTS/E file 
types and their meanings. 
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Table 1-2: 
File Type 
.B2S 

.BAC 

-BAK 

-BAS 
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File Types 

Meaning 

BASIC-PLUS-2 source file 

BASIC-PLUS compiled file 

Backup file created by several types of utility programs 
BASIC-PLUS source file 

BACKUP container set (or RMSBCK container set) 
A program written in C language. 

COBOL source file 

Command file 

DCL command file (or PBS Batch command file) 
Cross-reference listing file 

Batch control file (or OPSER based Batch) 

Data file 

DIBOL source file 

DIFFERENCES or FILCOM output file 

A file produced by the DIRECTORY command 
RUNOFF output file 

EDT initialization file 

System error file 

Terminal SETUP file 

FMS-11 form library file 

FORTRAN-IV source file 

FORTRAN-77 source file 

System program help text file 

Resident library file 

Input file used by the LINK command (Digital supplied) 
Batch output log file 

Listing file 

MACRO source file 

DECmail/RSTS mailbox file 


Table 1-2 (Cont.): File Types 
File Type Meaning 


-MAP Map file created by the LINK command or Task Builder 

-MLB MACRO Library file used by the RSX-based MACRO assembler 

.MSG DECmail message file 

OBJ Object file, which is a compiled BASIC-PLUS-2, COBOL, DIBOL, 
FORTRAN, or MACRO program 

.ODL Overlay Description Language input file used by the Task Builder 

-OLB Object module library file used by the Task Builder 

.OMS Operator/Message Services log file 

-PMD Postmortem dump file 

RNO RUNOFF input file 

RTS Run-time system 

SAV Executable FORTRAN-IV or MACRO program produced by the 
LINK command or the RT1ii-based LINK program 

SIL Save Image Library used by the RSTS/E monitor or system 
program 

SKL Skeleton file produced by the COBOL-81 compiler 

.SML RT11 source MACRO library 

SRT SORT-11 file 

STB Symbol table file produced by the Task Builder or linker 

SYS System file, usually reserved for use by the system 

.TEC TECO source file 

.TES TECO source program 

.TMP Temporary file created by a system program (deleted when you 
log out or if the disk is rebuilt) 

TSK Executable BASIC-PLUS-2, COBOL, DIBOL, FORTRAN-77, or 
MACRO program produced by the LINK command or the Task 
Builder 

-TXT ASCII text file 

-ULB A universal library 

.UNI Default file type for universal library files 
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File Specification Switches 
This section lists the RSTS/E file specification switches. 
/CLUSTERSIZE 


Specifies the cluster size for a disk file. A cluster is one or more 
contiguous disk blocks that the system treats as a unit when it creates 
or extends a file. Using a large cluster size for a large file speeds access 
to the data. 


You can specify a cluster size of 1, 2, 4, 8, 16, 32, 64, 128, or 256 blocks, 
depending on the type of disk. The default (and minimum) value is the 
disk’s pack cluster size. 


Format 
/CLTUSTERSIZE]:[-][#InL.] 
where: 


- Specifies a negative cluster size, which prevents an error if you 
specify a cluster size less than the disk’s pack cluster size. 
Specifies that n is an octal number. 
Specifies the cluster size in blocks. 


Specifies that n is a decimal number. The default is decimal. 
Example 
/CL:-8 


Assigns a cluster size of 8 or the disk’s pack cluster size, whichever is 
larger. 


/FILESIZE 
ISIZE 


Reserves space on disk for the file. When you create a file, use this 
switch to pre-extend the file to its final size. /FILESIZE and /SIZE are 
the same. When you do not pre-extend a file, system assigns a size of 0 
blocks when it creates the file and extends the file as data is written to 
it. 
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Format 
/FI[LLESIZE]:[#]n[.] or /SI[ZE]:[#]n[.] 


where: 

# Specifies that n is an octal number. 

n Specifies the number of blocks to pre-extend the file. 
Specifies that n is a decimal number. The default is decimal. 

Example 


/FI:3000 
Pre-extends a disk file to 3000 blocks. 
/MODE 


Lets you pass up to 15 bits of information to a device driver when 
you open a file. The meaning of the bits differs for each device and 
determines the read/write mode for data transfers. 


Format 

/MO[DE]:[#]n[.] 

where: 

# Specifies that n is an octal number. 

n Specifies the mode value, which can range from 0 to 32767 (decimal). 
Specifies that n is a decimal number. The default is decimal. 

Example 

/MO:16 


Specifies a contiguous disk file. 
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/POSITION 

Specifies the physical location of a file on disk. 
Format 

/PO[SITION]:n 

where: 


n specifies the device cluster number (in decimal) at which to place the 
first block of the file. Valid device cluster numbers depend on the disk 
size. 


Example 


/PO: 4000 


Causes the system to locate the disk file starting at device cluster 
number 4000. 


/PROTECTION 

Assigns a protection code to the file. The default protection code is 60. 
Format 

/PRLOTECTION]:[#]n1.] 

where: 


# Specifies that n is an octal number. 
n Specifies the protection code. 


Specifies that n is a decimal number. The default is decimal. 
Example 


/PR: 40 


Specifies a protection code of 40. 


/RONLY 


Sets read-only mode for a disk file. /RONLY is the same as 
/MODE:8192 for disk files. 


Format 
/RO[NLY] 
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File Protection Codes 


You assign protection codes to files in all RSTS/E command environ- 
ments except DCL by using the /PROTECTION switch. In DCL, you 
assign protection codes to files using the SET PROTECTION command 
or the /PROTECTION qualifier in several DCL commands. Table 1-3 
and Table 1-4 list RSTS/E protection codes and their meanings. 


Table 1-3: individual Protection Codes 
Code Meaning 


Protection against reading by the owner 
Protection against writing by the owner 


Protection against reading by the owner’s group 


8 Protection against writing by the owner’s group 
16 Protection against reading by anyone not in the owner’s group 
32 Protection against writing by anyone not in the owner’s group 
64 Executable program, which can be run 
128 A protected data file; overwritten with zeros when deleted 


When you add individual codes to executable protection code 64, the 
system interprets these codes differently from those previously listed. 


Table 1-4: Executable Protection Codes 
64 + Code Meaning 


1 Protection against executing by the owner 
2 Protection against reading and writing by the owner 
4 Protection against executing by the owner’s group 
8 Protection against reading and writing by the owner’s group 
16 Protection against executing by all others not in the owner’s 
group 


32 Protection against reading and writing by all others not in the 
owner’s group 


128 Program with privileges (cannot be used on .com files) 
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To determine the protection code you assign to a file, add up the 
individual code numbers for the types of protection you want. For 
example, the usual system default <60> protects against reading, 
writing, and deleting by all users except its owner, because it is the 
sum of 4, 8, 16, and 32. 


Table 1—5 lists some common protection codes and their meanings. 


Table 1-5: Commonly Used Protection Codes 


Code 
232 


124 


104 


62 


60 


48 


40 
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Sum of Codes 


128+644+32+8 


644+32+16+8+4 


644+32+8 


32416484442 


32+164+844 


32+16 


32+8+2 


32+8 


Meaning 


Executable file that is privileged and pro- 
tected against reading and writing by anyone 
except the owner. However, anyone can 
execute the file. 


Executable file that is protected against 
reading, writing, and execution by anyone 
except the owner. 


Executable file that is protected against 
reading and writing by anyone except the 
owner and that anyone can execute. 


Protection against reading by anyone except 
the owner. Protection against accidental 
deletion or modification by the owner or 
anyone else. 


Protection against reading and writing by 
anyone except the owner. 


Protection against reading and writing by 
anyone not in the owner’s group. Can be 
read or written by anyone in the owner’s 
group. 

Protection against writing by anyone includ- 
ing the owner, but is readable by everyone. 


Protection against writing by anyone except 
the owner, but is readable by everyone. 


No protection (any user can read, write, and 
delete). 


Device Names 


Each device on a RSTS/E system has a physical device name, also 
called a device designator or device specification. 


A physical device name consists of two or three letters, an optional 
unit number, and a colon (:). For example, "KBO:" is a "keyboard," 

or terminal, with the unit number 0. Other terminals on your system 
have similar device names assigned to them, such as "KB7:" or "KB35:". 
Three letter names are valid for keyboards only (see Table 1-6). 


If you do not specify a physical device name, the system assumes the 
public disk structure. For non-file-structured devices (line printer, and 
so forth), you need only specify the physical device name; the system 
ignores any file name, file type, or directory that you specify. 


If you do not specify a unit number, the defaults are: 


Disk - Public structure 
Tape - Unit 0 

Keyboard - Yours 

Line printer - Unit 0 
Flexible diskette - Unit 0 


Table 1-6 lists RSTS/E device designators. 


Table 1-6: RSTS/E Device Designators 


Designator Device 

DK:, DL:, DM:, RSTS/E public disk structure 

DP:, DR:, DB:, DU:, 

SY: 

SY0: System disk 

DKO: to DK7: RK0O5 disk units 0 through 7 

DLO: to DL3: RLO1/RLO2 disk units 0 through 3 

DMO: to DM7: RKO6/RKO7 disk units 0 through 7 

DRO: to DR?7: RM02/RM03/RM05/RM80 disk units 0 through 7 
DBO: to DB7: RP0O4/RP05/RPO6 disk units 0 through 7 
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Table 1-6 (Cont.): 
Designator 


DUO: to DU15: 


MTO0: to MT7: 
MMO: to MM7: 
MS0: to MS3: 
MUO: to MU1: 
LPO: to LP7?: 
TTn: 

TT: or TI: 


NL: 
PKn: 


DXO0: to DX7: or 
DY0: to DY7: 
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RSTS/E Device Designators 


Device 


RA60/RA70/RA80/RA81/RA82/RA90/RC25/RD3 V/RD32 
/RD51/RD52/RD53/RD54/RX33/RX50 disk units 0 
through 15 


CR11 punched or CM11 mark sense card reader 
CD11 punched card reader 

Your terminal 

Terminal n on your system 


Terminal on subline nn of a DL11 A,B type single line 
interface 


Terminal on subline nn of a DL11 C,D type single line 
interface 


Terminal on subline nn of a DLIIE type single line 
modem interface 


Terminal on subline nn of a static pseudo keyboard 
Terminal on subline nn of the DH multiplexers 
Terminal on subline nn of the DZ/DZV/DZQ multiplexers 


Terminal on subline nn of the DHV/DHU/DHQ/CX 
multiplexers 


Dynamic terminal number nn 

TE10/TU10/TS03 magnetic tape units 0 through 7 
TE16/TU16/TU45/TU77 magnetic tape units 0 through 7 
TS11/TU80/TS05/TK25 magnetic tape units 0 through 3 
TK50/TU8I/TU81E magnetic tape units 0 or 1 

Line printer units 0 through 7 

Terminal n in the system (synonym for KBn:) 


Your terminal (synonyms for KB:, the terminal that 
started the job) 


The null device 
Pseudo keyboard n 
RXO1/RX02 flexible diskette units 0 through 7 


NOTE 


If your system has only TS11, TU80, or TSV05 tape units, 
MS: and MT: are synonyms. If your system has only 
TE16, TU16, TU45, or TU77 tape units, MM: and MT: are 
synonyms. If your system has only TK50, TU81, or TU81E 
tape units, MU: and MT: are synonyms. On systems that 
have the CD11 card reader, CR: is a synonym for CD:. 


Logical Names 


You can assign a logical name to a physical device name, a directory, 
or a device/directory combination. A logical name consists of up to 15 
alphanumeric characters followed by a colon (:). Both user and system 


lagical namec allaw the the nndarcenare ( ) character Hawavar the 
Vt RARABBEYNY $4440 TT VWaAsw vaswyw ME AAWSA VY , ae WEES CAW YW EO Ce ah A ad wee 


Vasw 


dollar sign ($) character is only allowed in the system logical names. 


Logical names provide a convenient way to refer to devices and direc- 
tories that you use often. Logical names are also useful in programs 
and batch control files because they make them independent of physical 
locations of files and devices. For example, when you use a physical 
device name in a program, the program works correctly only if the 
device you refer to is mounted on the drive you specify. But when you 
use a logical name, you can mount the device on any free drive and 
assign the logical name to the device before running the program. 


Using the ASSIGN command, you can assign a logical name in any 
RSTS/E command environment. The command syntax is: 


ASSIGN dev:[[p,pn]] logical-name[:] 


In DCL, you can include a colon at the end of the logical name. In 
other RSTS/E command environments, such as BASIC-PLUS, you 
cannot include the colon. 


The following command assigns the logical name INDEX: to tape drive 
MMo.:. 
ASSIGN MMO: INDEX 


Any logical name you assign applies only to your job. The logical name 
stays in effect until you deassign it with the DEASSIGN command or 
log out. 
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RSTS/E Multiple Privileges 


Table 1-7 provides a summary of the RSTS/E multiple privileges. 


Table 1-7: Summary of RSTS/E Multiple Privileges 


Privilege 
none 
DATES 
DEVICE 
EXQTA 


GACNT 
GREAD 
GWRITE 
HWCFG 
HWCTL 


INSTAL 
JOBCTL 
MOUNT 
OPER 


PBSCTL 
RDMEM 


RDNFS 
SEND 


SETPAS 
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Description 


Most normal activity except those listed below. 
Change system clock and file dates. 
Access restricted devices. 


Exceed disk quota or memory maximum. (Not usually given 
to users; used by privileged programs.) 

Perform accounting operations on accounts in the user’s 
group. 

Read or execute any file in the user’s group, regardless of 
protection code. 


Write or create/rename any file in the user’s group, regard- 
less of protection code. 


Set hardware configuration parameters; for example, set 
terminal characteristics. 


Control devices; for example, disable a device or hang up a 
dialup line. 


Install run-time systems, swap files, and resident libraries. 
Manipulate other jobs; for example, detach or kill a job. 
Mount or dismount disks other than NOSHARE. 


Show, delete, or reply to operator requests and messages, 
and control the Operator/Message Services (OMS) package. 


Control print/batch services; for example, turn servers on or 
off, change printer forms. 


PEEK at memory. (Not usually given to users; used by 
privileged programs.) 


Read disks non-file-structured. 


Broadcast to terminals and send messages to restricted 
receivers. 


Change your own password. 


Table 1-7 (Cont.): Summary of RSTS/E Multiple Privileges 


Privilege 


SHUTUP 
SWCFG 


SWCTL 


SYSIO 


USER1-8 
WACNT 
WREAD 
WRTNFS 
WWRITE 


Description 


Shut down the system. 


Set software configuration parameters; for example, instal- 
lation name. 


Control software components; for example, turn DECnet on 
and off. 


Perform restricted I/O operations; for example, gain write 
access to files in account [0,*], or set the privilege bit in 
data files (files with the executable bit <64> not set). 


Perform functions that could easily modify the system; for 
example, poke memory. 


Control the setting of the privilege bit <128> in the protec- 
tion code of an executable program (files with the executable 
bit <64> set). 


Control system tuning parameters; for example, caching or 
job priority. 

Available for customer applications. Not used by RSTS/E. 
Perform accounting operations on any account. 

Read or execute any file regardless of protection code. 
Read/write a non-file-structured disk. 


Write any file regardless of protection code. Create/rename 
any file except account [0,*]. 
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Chapter 2 


DCL Commands 


This chapter describes how to enter DCL commands. It provides 
information on each DCL command such as privileges reauired and 
command qualifiers. 


Rules for Entering DCL Commands 


This section describes the rules for entering DCL commands. 


Uppercase and Lowercase Letters 


You can use any combination of uppercase and lowercase letters in DCL 
commands. 


Numbers 


DCL treats all numbers as decimal integers. 


Spaces and Tabs 


You must enter at least one space or tab between the command name 
and the first parameter and at least one space between additional 
parameters. You can use multiple spaces and tabs in all cases where 
you can use a single space or tab. For example: 


COPY DAY.DAT NIGHT.DAT 
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DCL ignores spaces and tabs at the beginning and end of a command 
string; around commas, plus signs, and equal signs; and around colons 
that delimit qualifier values. You cannot use spaces and tabs in file 
specifications, dates and times, keywords, and numbers. 


Qualifiers 


You type a qualifier after the command name but before pressing 
RETURN. You must precede each qualifier with a slash (/). You can 
include any number of spaces or tabs before or after the slash. For 
example: 


PRINT STATUS.RPT /COPIES=5 


Entering Qualifier Arguments 


Many qualifiers have arguments, which can be keywords, file specifica- 
tions, character strings, or numbers. You must separate a qualifier and 
its argument with either an equal sign (=) or a colon (:). For example: 


SET TERMINAL/WIDTH=132 
SET TERMINAL/WIDTH:132 


Command Line Labels 


Command line labels identify lines in a command procedure to which 
control passes when a GOTO or GOSUB command executes. Labels 
can be 1 to 255 characters long using the characters A-Z, 0-9, $, 

and _. Labels must appear as the first item on a command line, must 
be preceded by a dollar sign ($), and must be followed by a colon (:). 
For example: 


$LABELI : 


You cannot use labels that begin with a dollar sign ($), or include 
embedded spaces or tabs. You can specify only one label on a command 
line. You cannot use a label name more than once in a command 
procedure. 


2—2 DCL Commands 


Abbreviating Commands 


You can abbreviate command names, command keyword parameters, 
qualifiers, and qualifier keyword values: 


¢ You can always abbreviate command names, parameters, qualifiers, 
and qualifier arguments to the first four characters, excluding 
slashes and underscores. You can further abbreviate to the first 
two or three characters as long as the abbreviation is unique within 
DCL. For example: 


PR STATUS. RPT/FO=NORMAL 


¢ Some qualifiers permit a negated form. For example, /NOJOURNAL 
is the negated form of the /JOURNAL qualifier. When applying the 
minimum four-characier rule, do not inciude the NO prefix as two 
of the four characters. For example: 


EDIT/NOJOUR FILE.DAT 


Continuing Commands on More Than One Line 


The entire specification of a command is called the command string, 
which can be one or more physical command lines. You can enter up to 
132 characters on each physical line. When you use multiple physical 
command lines to continue a command string, type a hyphen (-) as the 
last character on each line before pressing RETURN. You can use as 
many physical lines as you want as long as the complete command 
string does not exceed 255 characters. 


For example: 

PRINT STATUS.RPT/COPIES=5, - 
Continue: CHKBK.B2S/COPIES=2, - 
Continue: CHAP3 .TXT/COPIES=10 


If you include a comment on the command line, the hyphen must be 
the last nonblank character before the comment. For example: 


PRINT STATUS.RPT/COPIES=2-!THIS IS A DRILL REPORT 


When you recall a command that has been entered on more than one 
line, the entire command is displayed on one line with the hyphens 
removed. 
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Entering File Specification Lists 


When you enter more than one file specification, separate them with 
commas (,) or plus signs (+). Any number of spaces or tabs can precede 
and follow the commas or plus signs. For example: 


DELETE JUNK.TXT, OLDPRG.B2S 
APPEND PART1.TXT +PART2.TXT+ PART3.TXT WHOLE.TXT 


Absolute Date Formats 


You can specify any date from 1-JAN-70 to 31-DEC-99. Use one of the 
following formats: 


¢ The alphanumeric format dd-mmm-yy. In this format, you specify 
June 13, 1989 as 13-JUN-89. You do not have to include leading 
zeros. You can also specify four digits for the year. When you omit 
the year, the current year is the default. 

¢ The numeric format yy.mm.dd. In this format, you specify April 9, 
1989 as 89.4.9. You do not have to include leading zeros. You can 
also specify four digits for the year. 


¢ The keywords TODAY, TOMORROW, or YESTERDAY. The current 
system date determines the values for these keywords. 


Absolute Time Formats 


Use one of the following formats: 


¢ The 24-hour format hh:mm. In this format, hh is the hour in the 
range 0 to 24 and mm is the minute in the range 0 to 59. The 
minute is optional. 


00:00 is midnight, and is considered the beginning of the specified 
date. 


12:00 is noon. 24:00 is midnight, and is considered the end of the 
specified date. 
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The AM/PM format hh:mmAM, hh:mmP\M, or 12:00M. In this 
format, hh is the hour in the range 1 to 12, mm is the minute in 
the range 0 to 59, and M stands for meridian (noon). Do not include 
a space between the minute and AM, PM, or M. Use 12:00AM to 
specify midnight. 


Combining Absolute Dates and Times 


To specify both date and time, use date:time, where date and time are 
any of the absolute date and time formats previously described. For 
example: 


16-DEC-89:11:00AM 
TOMORROW: 1:00AM 


If you specify only a time, the date default is TODAY. If you specify only 
a date when using the /AFTER qualifier, the time default is 11:59PM. 
That is, the job is processed at the end of the specified day. 


Relative Dates and Times 


Use one of the following formats: 


To change the date using relative dates, use the format +nD[AYS] 
or -nD[AYS]. For example: 


+23D, which increments the specified absolute date by 23 days. If 
you do not specify an absolute date, the date default is TODAY. 
To change the time in a DATE:TIME specification, use +nH[OURS] 


or -nH[OURS] to change the hour. To change the minute, use 
+nM[INUTES] or -nM[INUTES]. For example: 


-2HOURS-20MINUTES indicates a time 2 hours and 20 minutes 
from the absolute time. If you do not specify an absolute time, the 
time default is the current time. 


You can specify these formats in any order and in any combination. 
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Combining Absolute and Relative Dates and Times 


When you combine absolute and relative dates and times, you must 
specify the absolute date and time first, immediately followed by the 
relative date and time. For example: 


10-AUG-89:10:12AM-2DAYS+3HOURS+3 0MINUTES 


returns 8-Aug-89 at 1:42PM. 


DCL Commands and Qualifiers 
This section lists RSTS/E DCL commands and qualifiers. 


@file-spec [P1 [P2 [...P8]] 


Executes a DCL command procedure. 


Privilege required: Read access to the command procedure file. 


ALLOCATE dev{[:] [logical-name[:]] 


Reserves a device, if it is not currently allocated by another user, so 
that only you can use it. Optionally assigns a logical name to the 
device. A logical name consists of up to 15 alphanumeric characters 
and can include underscores (_). 

Privilege required: 

¢ DEVICE if the device is restricted 


¢ HWCTL to use the /SEIZE or /JOB qualifier for an account other 
than your own 


Command Qualifiers 


/JOB=n 
Allocates the device to the specified job number. 
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/[INOJ]QUEUVED 

Specifies the queuing characteristic of the local LAT port you are 
allocating. This setting is in effect until you deallocate the device. If 
/QUEUED is specified, connections initiated by this local LAT port to 
a terminal server will be placed on the server’s queue if the server 
supports queuing and the remote port is busy. If /NOQUEUED is 
specified and the remote port is busy, connections will not be queued 
and it will fail. 


Use the SHOW PORT command to display the port’s connection status. 
If the port is set (QUEUED and the remote port is busy, a connection 
status of "In Progress" and the position in the queue wili be shown. 


The default is the queued setting of the port when it was created or 
assigned. 


/SEIZE 
Reallocates the device currently allocated to another job to the specified 
job, unless the device is currently in use by the other job. 


APPEND [node::]Jinput-filespec[,...] [node::joutput-filespec 
Adds the contents of one or more files to the end of an existing file. 
Privilege required: 
¢ Read access to the input files 
e Write access to the output file 


Command Qualifiers 


/BEFORE=date 

/CREATED 

/MODIFIED 

/SINCE=date 

Appends files created or modified before or since the specified date. 


/[NOJCONFIRM 
Indicates whether to prompt before appending files and is a synonym 
for /[NO]JQUERY. The default is /NOCONFIRM. 


/[NOJLOG N 
Indicates whether to display a confirmation message for each file 
appended. The default is /LOG. 
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/INO]QUERY NN 

Indicates whether to prompt before appending files. The default is 
/NOQUERY. 

=SIZE=n 

=SIZE=MINIMUM=n 

=SIZE=MAXIMUM=n 
=SIZE=(MINIMUM=m,MAXIMUM=n) 

Selects files based on their size. The specified size can be: 


/SELECT 


n Selects only those files with size equal to n. 

MINIMUMEn Selects only those files with size greater 
than or equal to n. 

MAXIMUME=n Selects only those files with size less than 


or equal to n. 
MINIMUM=m,MAXIMUMen Selects only those files with size between m 


and n inclusive. 


ASSIGN dev:|[[p,pn]] logical-name[:] 


Assigns a logical name to a directory or a physical device. A logical 
name consists of up to 15 alphanumeric characters and can include 
underscores (_). Systemwide logical names can also include dollar signs 


($). 
Privilege required: INSTAL to use the /SYSTEM qualifier 


Command Qualifier 


/[NOJREPLACE[=QUERY] 

Replaces a logical name if it already exists and is used with the 
/SYSTEM or /USER qualifiers. If not specified with /SYSTEM, the 
default is /REPLACE=QUERY. If not specified with /USER, the default 
is /REPLACE. 


‘SYSTEM 
Assigns a systemwide logical name to a device and/or PPN. /USER is 
the default if neither (SYSTEM nor /USER is specified. 


/USER 
Assigns a user-defined logical name to a device and/or PPN. /USER is 
the default if neither /SYSTEM nor /USER is specified. 
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ASSIGN/PORT port-name[:] server-name 


Assigns a local LAT port on the RSTS/E node to a remote terminal 
server. You must select a remote service and/or a remote port offered 
by the specified terminal server. 


The port-name parameter specifies the name of the local port that will 
be assigned to the terminal server. The port-name must be in the form 
of KBIn: or KBn: where n is a value from 0 through 127. The server- 
name specifies the name of a remote terminal server to which the port 
can be connected. The server-name can be up to 16 alphanumeric 
characters in length. 


Privilege required: SWCFG 
Command Qualifier 


/APPLICATION 
Specifies that this port is to be used as an application terminal. The 
default is /APPLICATION. 


/LAT 
Assigns a LAT port. The default is /LAT. 


/INO]JLOG 
Indicates whether to display a confirmation message after the port is 
assigned. The default is /LOG. 


/[NOJQUEUED 

Indicates whether the connection to a terminal server will be placed on 
the server’s queue if the remote port is busy and the server supports 
queuing. If /NOQUEUED is specified and the remote port is busy, the 
connection will not be queued and it will fail. The default is /QUEUED. 


Use the SHOW PORT command to display the port’s connection status. 
If the port is set /(QUEUED and the remote port is busy, a connection 
status of "In Progress" and the position in the queue will be shown. 


/REMOTE_PORT=remote-port-name 

Specifies the name of a remote port on the terminal server to which the 
local LAT port is to be connected. The remote port name can be up to 
16 alphanumeric characters in length. 


You must select either a remote port or a service. 
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/SERVICE=service-name 

Specifies the name of a remote service offered at the terminal server to 
which the local LAT port is to be connected. The service name can be 
up to 16 alphanumeric characters in length. 


You must select either a remote port or a service. 


ASSIGN/QUEUE queue-name[:] server-name[:] 


Assigns a server to a queue. 


Privilege required: PBSCTL 


ATTACH job-number 


Attaches you to a detached job. If the job is running under an account 
other than your own, you must enter the password for that account 
unless you have GACNT or WACNT privilege, as appropriate. 


Privilege required: 
e GACNT to attach to a job in your group without using a password 
° WACNT to attach to a job in any account without using a password 


BACKUP input-filespec[,...] output-backup-set-spec 


Copies individual disk files or entire volumes onto a tape or disk 
backup saveset. 


Privilege required: 

© Read access to input files 

¢ Create access to backup set file 

¢ INSTAL to exceed system dynamic region limit 


¢ TUNG to use the /BUFFER_SIZE qualifier and for better system 
performance 


¢ WACNT or GACNT to use the /ACCOUNT_DATA qualifier 
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Command Qualifiers 


/[NOIACCOUNT_DATA 

Indicates whether to create the information necessary to restore or up- 
date account data for each account that meets the selection criteria. If 
you specify /NOACCOUNT_DATA, BACKUP will back up file data only 
and will not back up account information. The default is /ACCOUNT_ 

DATA. 


/[NOJASSIST 

Indicates how to send media mount requests to an operator. By specify- 
ing /ASSIST, you can send the disk or tape media mount requests to an 
operator through the Operator/Message Services (OMS). The default, 
/NOASSIST, sends media mounts requests through your terminal. 


/BLOCK_SIZE=n 

Specifies the number of bytes written to each record (block) of the 
output saveset file; valid range for n is 2048 to 28672 for tapes and 
disks. Specify block size for tapes in multiples of 16; specify block 
size for disks in multipies of 512. You can also specify MINIMUM or 
MAXIMUM. The default is 28672 bytes for disks and 16384 bytes for 
tapes. 


/BUFFER_SIZE=n 

Specifies the size in k-words of the backup buffer in memory. Larger 
values may improve performance at the expense of greater system 
impact. The valid range for n is 3 to 255 or MAXIMUM. You can also 
specify OPTIMUM or 55. The default is the minimum usable size, 
except when using an MS- or MU-class tape drive in which case the 
default is 55. 


/[NOJCRC 

Indicates whether to calculate and include a cyclic redundancy check 
(CRC) value for each block of data written to the backup file. The 
default is /NOCRC. 


/CREATED=date 

/CREATED=(BEFORE=date:time, AFTER=date:time) 
/MODIFIED=date 

/MODIFIED=(BEFORE=date:time, AFTER=date:time) 

Backs up files created or modified on, before, after, or between the 
specified date:times. The date:time argument can be any valid DCL 
date and/or time. 


DCL Commands 2-11 


/DENSITY=n 

Specifies the recording density of the output tape. Specify any valid 
density for the magnetic tape you are using for output. Currently 
available densities are 800, 1600, 6250, 6667, 8000, and 10000 bpi. You 
can also specify MINIMUM or MAXIMUM, which causes the system to 
set the density to the minimum or maximum the tape drive supports. 


If you do not specify a density, BACKUP uses the system default 
density. 


If you specify a density that the tape drive does not support, you receive 
a warning message and the pyelems selects the next higher density the 
tape drive supports. 


If you specify a density that is higher than the highest density the tape 
drive supports, you receive a warning message and the system selects 
the tape drive’s maximum density. 


/END={[NOJREWIND | [NOJDISMOUNT} 

Specifies whether to rewind the output tape drive or dismount the 
output disk following the successful completion of the backup operation. 
The default for disks is /END=DISMOUNT. The default for tapes is 
/END=NOREWIND. 


/EXCLUDE=(filespec-list) 
Excludes files transferred to the saveset. 


/[NOJFILE_DATA 
Indicates whether to transfer files to the saveset. The default is /FILE_. 
DATA. 


/[NO}]GROUP_SIZE[=n] 
Specifies the group size for XOR redundancy; the valid range for n is 0 
to 100. The default is /GROUP_SIZE=10. 


/INCLUDE=(filespec-list) 
Specifies the files or accounts you want transferred to the saveset. 


/AINOJINITIALIZE[=((NOJERASE,[NOJEXERCISE,EXERCISE=n, 
CLUSTER_SIZE=n,[NO]JQUERY)] 

Indicates whether to initialize the output tape or disk before creating 
the backup file. For tape volumes, /INITIALIZE specifies that the tape 
be initialized as a standard ANSI tape. 
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For disk volumes, /INITIALIZE specifies that the disk be initialized 
based on the attributes (pack ID, pack cluster size, etc.) of the input 
disk. The arguments ailow you to have more control over the initializ- 
ing of disks in the backup operation. For /INITIALIZE=EXERCISE=n, 
n can be 0, 1, 2, or 3. For INITIALIZE=CLUSTER_SIZE=n, n can be 
1, 2, 4, 8, 16, 32, or 64. The default is /NOINITIALIZE. 


/IN_LABEL=name 
Specifies the name you want compared to the source volume ID. 


/[NOJLIST_FILE[=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
backup events. The log contains information about the accounts and 
files transferred, and the disk volumes used. The default is /LIST_ 
FILE=KB: or your terminal. 


/OUT_LABEL=name 

Specifies the name used for the output wali ID and provides a 
means to ensure that you are referencing the correct output device. 

If the /INITIALIZE qualifier is not specified and the volume ID does 
not match the one found on the specified output device, then BACKUP 
displays an error and rejects the command. If the /INITIALIZE qual- 
ifier is specified, then the output device label will be set to the name 
specified with /OUT_LABEL. 


(INOJOUTPUT[=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
backup events and is a synonym for /[NOJLIST_FILE. The log contains 
information about the accounts and files transferred, and the disk 
volumes used. The default is /OUTPUT=KB: or your terminal. 


/[NOJPROMPT 
Indicates whether to prompt for the first volume name. The default is 
/PROMPT. 


/INOJQUERY 

Indicates whether to prompt before transferring each file meeting the 
selection criteria. The default is /NOQUERY. Answer Y or YES to 
transfer the file displayed, or N or NO to skip the file and continue 
with the next file. The default, /NOQUERY, transfers each file selected 
without prompting. 
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You can also specify /ALL with the YES or NO reply to indicate that 
the reply applies to all remaining file transfers. This eliminates further 
queries, YES/ALL causes all remaining files to be transferred and 
NO/ALL causes all remaining files to be skipped. 


/INOJREWIND 
Indicates whether to rewind a magnetic tape saveset volume before 
processing. The default is /NOREWIND. 


/[NOJVERIFY[=ONLY] 

Indicates whether to perform a comparison operation of all data trans- 
ferred. If you specify /VERIFY, then BACKUP performs a second pass 
through the input disk, comparing each account and file transferred 
with that on the output backup set. BACKUP reports any differences 
found. 


You can use BACKUP/VERIFY=ONLY to perform a verify operation 
without transferring any data. It also allows you to create several 
backup sets on one tape and verify the sets all at once; thus, you do not 
have to wait for the tape to rewind and position itself before each verify 
operation. The default is /NOVERIFY. 


BACKUP/COPY input-filespec[,...] output-filespec 


Copies files and/or accounts from one disk to another. Note that the 
default for the output PPN is the input PPN. 

Privilege required: 

¢ Read access to input files 

¢ Create access to output files 

¢ DATES to preserve file creation and access dates 

¢ INSTAL to exceed system dynamic region limit 

¢ SYSIO to copy files to [0,1] 


e TUNE to use the /BUFFER_SIZE qualifier and for better system 
performance 


¢ WACNT or GACNT to use the /ACCOUNT_DATA qualifier 
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Command Qualifiers 


/INOJACCOUNT_DATA 

Indicates whether to create or update accounts on the output disk. 
/ACCOUNT_DATA creates any account that does not already exist 
on the output disk. If the account exists on the output disk, then 
BACKUP/COPY updates the account’s attributes to match those of 
the account on the input disk. If you specify /NOACCOUNT_DATA, 
BACKUP/COPY will not transfer any files to an account that does not 
exist on the output disk. The default is /ACCOUNT_DATA. 


/[INOJASSIST 

Indicates how to send media mount requests to an operator. By spec- 
ifying /ASSIST, you can send the disk media mount requests to an 
operator through the Operator/Message Services (OMS). The default, 


/NOASSIST, sends media mount requests through your terminal. 


/BLOCK_SIZE=n 

Specifies the number of bytes written to each record (block) of the 
output saveset file; valid range for n is is 2048 to 28672. Specify 
block size in multiples of 512. You can also specify MINIMUM or 
MAXIMUM. The default is 28672 bytes. 


/BUFFER_SIZE=n 

Specifies the amount of memory in k-words to allocate for buffering 
data, in the range 4 to 255, or MAXIMUM. BACKUP/COPY uses 
buffers which are multiples of 4K-words. If you specify a value which 
is not a multiple of 4, BACKUP/COPY rounds your value down to the 
next lower multiple of 4. 


The maximum /BUFFER_SIZE value allowed is the largest free area 
in memory with sufficient additional space to support one job at the 
defined "swap maximum". 


/CREATED=daite:time 

/CREATED=(AFTER=date:time, BEFORE=date:time) 
/MODIFIED=date:time 

/MODIFIED=(AFTER=date:time, BEFORE=date:time) 

Copies files created or modified on, before, after, or between the spec- 
ified date:times. The date:time argument can be any valid DCL date 
and/or time. 
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/END=[NO]DISMOUNT 
Specifies whether to dismount the output disk following the successful 
completion of the operation. The default is /END=DISMOUNT. 


/EXCLUDE=filespecf{,...] 

Specifies one or more files that should not be transferred. This qualifier 
is useful when you use wildcards to select a group of files, but want 

to exclude particular files from the group. You do not need to list files 
that have been set to IGNORE (see "SET FILE"). 


/[NOJFILE_DATA 

Indicates whether to transfer file data - or only account data - from 
the input to the output disk. Specify /NOFILE_DATA in conjunction 
with /ACCOUNT_DATA to create or update accounts on the output disk 
without transferring any files. The default is /FILE_DATA. 


/INCLUDE=filespec{,...] 

Specifies one or more files that should be transferred, regardless of any 
other selection criteria. For example, if you select files based on their 
creation date, you can still transfer files that would not otherwise be 
selected. 


/INOJINITIALIZE[=((NOJERASE, [NOJEXERCISE,EXERCISE=n, 
CLUSTERSIZE=n, [NOJQUERY)] 

Indicates whether to initialize the output disk before creat- 

ing the backup file. The arguments allow you to have more 
control over the initializing of disks in the backup operation. 

For /AINITIALIZE=EXERCISE=n, n can be 0, 1, 2, or 3. For 
/INITIALIZE=CLUSTERSIZE=n, n can be 1, 2, 4, 8, 16, 32, or 64. 
The default is /NOINITIALIZE. 


If you specify /INITIALIZE, the output disk will be initialized based on 
the attributes (pack ID, pack cluster size, etc.) of the input disk. The 
default is NOINITIALIZE. 


/IN_LABEL=label 

Specifies the pack ID of the input disk and provides a means to ensure 
that you are referencing the correct input disk. If the pack ID does 
not match the one found on the specified input disk, then BACKUP 
displays an error and rejects the command. 
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/[NOJLIST_FILE[=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
backup events. The log contains information about the accounts and 
files transferred, and the disk volumes used. 


/INOJOPTIMIZE 

/OPTIMIZE=CLUSTER_SIZE 

/OPTIMIZE=DIRECTORY 

Indicates whether to optimize file cluster sizes, file directories, or 
both on the output disk. The default, /OPTIMIZE, performs both 
optimizations. 


/OUT_LABEL=label 

Specifies the name used for the pack ID of the output disk and provides 
a means to ensure that you are referencing the correct output disk. If 
the /INITIALIZE qualifier is not specified and the pack ID does not 
match the one found on the specified output disk, then BACKUP dis- 
plays an error and rejects the command. If the /INITIALIZE qualifier 
is specified, then the output disk label will be set to the name specified 
with /OUT_LABEL. 


ANOJOUTPUT|=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
backup events and is a synonym for /[NOJLIST_FILE. The log contains 
information about the accounts and files transferred, and the disk 
volumes used. 


/PLACED_POSITION=position 
Indicates where to position files that you are transferring and are 
marked as placed; position can be: 


INDEX Place files near the master file index on the output 
disk (recommended location). 

MIDDLE Place files at the logical center of the output disk. 

ORIGINAL Places files at or after their location on the input 


disk. Generally, you should not use ORIGINAL when 
transferring placed files to an output disk whose size is 
different than the input disk. 


The default is /PLACED_POSITION=INDEX. 


/INOJPROMPT 
Indicates whether to prompt before beginning the BACKUP operation. 
The default is (PROMPT. 
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/[INOJQUERY 

Indicates whether to prompt before copying each file selected. 
Specifying /QUERY displays the name of each file selected and asks 

if you want to copy that file. Answer Y or YES to copy the file dis- 
played, or N or NO to skip the file and continue with the next file. The 
default, /NOQUERY, copies each file selected without prompting. 


You can also specify /ALL with the YES or NO reply to indicate that 
the reply applies to all remaining file transfers. This eliminates further 
queries. YES/ALL causes all remaining files to be copied and NO/ALL 
causes all remaining files to be skipped. 


/[NOJREPLACE[=QUERY] 

Indicates what action should be taken if a file to be copied already ex- 
ists on the output disk. If you specify (REPLACE, then BACKUP/COPY 
replaces the file if it exists; any existing file is deleted. If you specify 
/NOREPLACE, then BACKUP issues a warning and does not replace 
the file if it already exists. 


The default, /REPLACE=QUERY, prompts you to replace any file that 
already exists. Answer Y or YES to replace the current file. Answer N 
or NO to not replace the existing file and proceed with the next file. 


You can also specify /ALL with the YES or NO reply to indicate that 
the reply applies to all remaining file replacements. This eliminates 
further queries. YES/ALL causes all remaining files to be replaced and 
NO/ALL causes all remaining files to be skipped. 


/[NOJVERIFY[=ONLY] 

Indicates whether to perform a comparison operation of the all 

data transferred to the output disk. If you specify /VERIFY, then 
BACKUP/COPY performs a second pass through the input disk, com- 
paring each account and file transferred with that on the output disk. 
BACKUP/COPY reports any differences found. 


You can use BACKUP/COPY/VERIFY=ONLY to perform a verify 
operation without transferring any data. The default is /NOVERIFY. 
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BACKUP/DIRECTORY backup-set-spec 


Lists files within a backup saveset. 
Privilege required: 
¢ Read access to the backup set file 


e INSTALL to exceed system dynamic region limit 
e TUNE to use the /BUFFER_SIZE qualifier 


Command Qualifiers 
/[NOJASSIST 


Indicates how to send media mount requests to an operator. By speci- 
fying /ASSIST, you can send a disk or tape media request to mount a 

saveset to an operator through the Operator/Message Services (OMS). 
The default, /NOASSIST, sends media mounts requests through your 

terminal. 


/BRIEF 
Displays a format similar to the DCL full directory (minus file at- 
tributes) and is the default qualifier. The default is /BRIEF. 


/BUFFER_SIZE=n 

Specifies the size in k-words of the backup buffer in memory. Larger 
values may improve performance at the expense of greater system 
impact. The valid range for n is 3 to 255 or MAXIMUM. You can also 
specify OPTIMUM or 55. The default is the minimum usable size, 
except when using an MS- or MU-class tape drive in which case the 
default is 55. 


/CREATED=date 

/CREATED=(BEFORE=date:time, AFTER=date:time) 
/MODIFIED=date 

/MODIFIED=(BEFORE=date:time, AFTER=date:time) 

Lists files created or modified on, before, after, or between the specified 
date:times. The date:time argument can be any valid DCL date and/or 
time. 


/END={[NOJREWIND | [NOJDISMOUNT} 

Specifies whether to rewind the output tape drive or dismount the 
output disk following the successful completion of the backup operation. 
The default for disks is /END=DISMOUNT. The default for tapes is 
/END=NOREWIND. 
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/EXCLUDE=(filespec-list) 
Specifies one or more files that should not be listed. 


/FULL 
Displays detailed information for each file on multiple lines. 


To display information for specific files use /SELECT or /EXCLUDE 
with BACKUP/DIRECTORY. 


/INCLUDE=(filespec-list) 
Specifies the files or accounts that should be listed. 


/JIN_LABEL=name 
Specifies the name you want compared to the source volume ID. 


/[NOJLIST_FILE[=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
backup events. The log contains information about the accounts and 
files transferred, and the disk volumes used. The default is /LIST_ 
FILE=KB: or your terminal. 


/OCCURRENCE=number 
Specifies the occurrence of the named backup set used in the BACKUP 
process. The default is the first occurrence. 


/[NOJOUTPUT[=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
BACKUP events and is a synonym for /[NO]LIST_FILE. The default is 
/OUTPUT=KB: or your terminal. 


/[NOJPROMPT 
Indicates whether to prompt for the first volume name. The default is 
/PROMPT. 


/[INOJREWIND 
Indicates whether to rewind a magnetic tape saveset volume before 
processing. The default is /NOREWIND. 


/SELECT=(filespec-list) 
Specifies the files you want to list. The default is all files in the backup 
set. 
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BACKUP/IMAGE input-disk: output-disk: 


Copies all accounts and files from one disk volume to another and 
makes the output volume bootable if the file [0,1JINIT.SYS is copied. 
Privilege required: 

¢ Read access to input files 

¢ Create access to output files 

¢ DATES to preserve file creation and access dates 

e INSTAL to exceed system dynamic region limit 

¢ RDNEFS, WRTNES, and SYSMOD to make the output disk bootable 
e SYSIO te copy files to [0,1] 

e TUNE to use the /BUFFER SIZE 
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Command Qualifiers 
/[NOJASSIST 


Indicates how to send media mount requests to an operator. By spec- 
ifying /ASSIST, you can send the disk media mount requests to an 
operator through the Operator/Message Services (OMS). The default, 
/NOASSIST, sends media mounts requests through your terminal. 


/BLOCK_SIZE=n 

Specifies the number of bytes written to each record (block) of the 
output saveset file; valid range for n is is 2048 to 28672. Specify 
block size in multiples of 512. You can also specify MINIMUM or 
MAXIMUM. The default is 28672 bytes. 


/BUFFER_SIZE=n 

Specifies the amount of memory in k-words to allocate for buffering 
data, in the range 4 to 255, or MAXIMUM. BACKUP/IMAGE uses 
buffers which are multiples of 4K-words. If you specify a value which 
is not a multiple of 4, BACKUP/IMAGE rounds your value down to the 
next lower multiple of 4. 


The maximum /BUFFER_SIZE value allowed is the largest free area 
in memory with sufficient additional space to support one job at the 
defined "swap maximum". 
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/END=[NO]DISMOUNT 
Specifies whether to dismount the output disk following the successful 
completion of the backup operation. The default is /END=DISMOUNT. 


/IN_LABEL=label 

Specifies the pack ID of the input disk and provides a means to ensure 
that you are referencing the correct input disk. If the pack ID does 
not match the one found on the specified input disk, then BACKUP 
displays an error and rejects the command. 


/[NOJINITIALIZE[=(INOJERASE, [NOJEXERCISE,EXERCISE=n, 
CLUSTERSIZE=n, [NOJQUERY)] 

Indicates whether to initialize the output disk before creating 

the backup file. The arguments allow you to have more con- 

trol over the initializing of disks in the backup operation. For 
AINITIALIZE=EXERCISE=n, n can be 0, 1, 2, or 3. For 
/JINITIALIZE=CLUSTERSIZE=n, n can be 1, 2, 4, 8, 16, 32, or 64. The 
default is /NOINITIALIZE. 


If you specify /INITIALIZE, the output disk will be initialized based on 
the attributes (pack ID, pack cluster size, etc.) of the input disk. Use 
the /OUT_LABEL qualifier to specify a different pack ID for the output 
disk. The default is /NOINITIALIZE. 


/[(NOJLIST_FILE[=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
backup events. The log contains information about the accounts and 
files transferred, and the disk volumes used. 


/[INOJOPTIMIZE 

/OPTIMIZE=CLUSTER_SIZE 

/OPTIMIZE=DIRECTORY 

Indicates whether to optimize file cluster sizes, file directories, or 
both on the output disk. The default, /OPTIMIZE, performs both 
optimizations. 


Use /OPTIMIZE=CLUSTER_SIZE to perform cluster size optimization 
without directory optimization. Likewise, use /OPTIMIZE=DIRECTORY 
to perform directory optimization without performing cluster size 
optimization. 
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[INOJOUTPUTI=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
backup events and is a synonym for /[NO]LIST_FILE. The log contains 
information about the accounts and files transferred, and the disk 
volumes used. 


/OUT_LABEL=label 

Specifies the name used for the pack ID of the output disk and provides 
a means to ensure that you are referencing the correct output disk. If 
the /INITIALIZE qualifier is not specified and the pack ID does not 
match the one found on the specified output disk, then BACKUP dis- 
plays an error and rejects the command. If the /INITIALIZE qualifier 
is specified, then the output disk label will be set to the name specified 
with /OUT_LABEL. 


{PLACED | POSIT! ON=vosition 


haw mm PULL 
Indicates where to position files that you are transferring and are 
marked as placed; position can be: 


INDEX lace files near the master file index on the output 
disk (recommended location). 

MIDDLE Place files at the logical center of the output disk. 

ORIGINAL Places files at or after their location on the input 


disk. Generally, you should not use ORIGINAL when 
transferring placed files to an output disk whose size is 
different than the input disk. 


The default is /PLACED_POSITION=INDEX. 


/INOJPROMPT 

Indicates whether to prompt before beginning the BACKUP operation. 
The default is /PROMPT. 

/INOJREPLACE[=QUERY] 

Indicates what action should be taken if a file to be transferred already 
exists on the output disk. If you specify (REPLACE, then BACKUP 
replaces the file if it exists. Any existing file is deleted. If you specify 
/NOREPLACE, then BACKUP issues a warning and does not replace 
the file if it already exists. 


The default, /REPLACE=QUERY, prompts you to replace any file that 
already exists. Answer Y or YES to replace the current file. Answer N 
or NO to not replace the existing file and proceed with the next file. 
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You can also specify /ALL with the YES or NO reply to indicate that 
the reply applies to all remaining file replacements. This eliminates 
further queries. YES/ALL causes all remaining files to be replaced and 
NO/ALL causes all remaining files to be skipped. 
/[NOJVERIFY[=ONLY] 

Indicates whether to perform a comparison operation of all data 
transferred to the output disk. If you specify /VERIFY, then 
BACKUP/IMAGE performs a second pass through the input disk, 


comparing each account and file transferred with that on the output 
disk. BACKUP/IMAGE reports any differences found. 


You can use BACKUP/IMAGE/VERIFY=ONLY to perform a verify 
operation without transferring any data. The default is /NOVERIFY. 


BASIC 


Invokes the BASIC-PLUS or BASIC-PLUS-2 programming environ- 
ment. 


Privilege required: none 


Command Qualifiers 


/BP2 
Invokes the BASIC-PLUS-2 programming environment. /BP2 is the 
default when no qualifier is specified. 


/BPLUS 
Invokes the BASIC-PLUS programming environment. 


BROADCAST destination[,...] "message" 


Sends a message to the specified users or terminals; destinations 
can be PPNs that include wildcard characters or keyboard device 
specifications. You must specify a destination, or use the /ALL or 
/LOGGED_IN qualifiers. You can broadcast a single- or multiline 
message, or a complete file. 


Privilege required: SEND 
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Command Qualifiers 


/ALL 

Broadcasts the message to all terminals. You cannot specify a destina- 
tion with /ALL. 

/[NOJBELL 

Indicates whether to include a BELL character ahead of the message. 
The default is /NOBELL. 


/[NOJHEADER 
Indicates whether to include a header before the message. The default 
is /HEADER. 


/LOGGED_IN 


Broadcasts the message io all logged-in terminais. You cannot specify a 
destination with /LOGGED IN. 


CC filespecf{,...] 
Invokes the PDP-11 C compiler to compile C source programs. 


Command Qualifiers 


/DEFINE=("identifier[(param,...)] token-string” [,...]) 
Defines a token string or macro to be substituted for every occurrence 
of a given identifier in the program. 


/ENVIRONMENT=(([NO]FPU,[NO]JPIC) 
Specifies the type of environment in which the generated code is to 
execute and/or in which the object module(s) is to be linked. 


/[NOJERROR_LIMIT[=qualifier] 
Indicates whether to specify the error count at which compilation will 
stop. The default is /ERROR_LIMIT=30. 


/INOJINCLUDE_DIRECTORY=(pathnamef....]) 
Indicates whether to provide an additional level of search for include 
files. The default is /NOINCLUDE_DIRECTORY. 


/[NOJLIST[=filespec] 
Indicates whether to create a listing file. The default is /NOLIST. The 
default output file extension is .LST. 
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/[NOJMACRO[=filespec] 
Indicates whether to create a macro listing file. The default is 
/NOMACRO. The default output file extension is .MAC. 


/[NOJMEMORY[=qualifier] 

Determines the amount of extended memory to allocate in a PDP-11 
host environment. The default is /NOMEMORY. 
/INOJMODULE=(identifier | "string"[,identifier | "string"]) 

Controls the compiler produced output module header for the program 
file. 


(INOJOBJECT[=filespec] 
Indicates whether to create an object file. The default output file 
extension is .OBJ. 


/SHOW[=option,...] 
Displays information about the file being compiled. Option can be: 


ALL Prints all information 

[NOJCONDITIONALS Prints condition program segments. Default is 
CONDITIONALS. 

[NOJEXPANSION Prints final macro expansions. The default is 
NOEXPANSION. 

[NOJINCLUDE Prints contents of #include files. The default is 
NOINCLUDE. 

[NO]JINTERMEDIATE Prints intermediate macro expansions. The 
default is INTERMEDIATE. 

NONE Prints no listing information. 

[NOJMACHINE_CODE Prints the generated machine code. The 
default is MACHINE_CODE. 

[NOJSOURCE Prints the source file statements. The default 
is SOURCE. 


/[NOJSTANDARD[=(option.,...)] 
Determines what language features are allowed or flagged as non- 
standard. The default is /STANDARD=ANSI. 


/[[NOJTERMINAL[=[NO]JSOURCE] 

Indicates whether to display compiler messages at the terminal. The 
default is /TERMINAL=NOSOURCE, or as established during installa- 
tion of PDP-11 C. 
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/[NOJTITLE=(identifier) 
Controls the compiler produced output list header for the program file. 
The defauit is /NOTITLE. 


/[NOJUNDEFINE=(identifier[....]) 
Indicates whether to undefine the predefined PDP-11 C preprocessor 
constants. The default is /NOUNDEFINE. 


/INOJWARNINGS[=(option,...)] 

Indicates whether to force the compiler to print both informationals and 
warnings. Option can be NOINFORMATIONALS or NOWARNINGS. 
The default is /(WARNINGS. 


/[NOJWORK_FILE_SIZE=integer-number 

Indicates whether to allocate the number of 512-byte disk blocks for 

the work file. The integer-number is an integer value between 1 and 
65535. The default is /(WORK_FILE_SIZE=2048. Use with the /LIST 
qualifier to set or cancel specific listing options. 


CCL system-command 


Allows you to use a system CCL command that has the same name as 
a DCL command. 


Privilege required: Execute access to the system command program 


CLOSE channel-number 


Closes a file that you opened using the OPEN command and removes 
the associated channel number from the list of open channels. 


Privilege required: none 


Command Qualifier 


/ALL 
Closes all currently open channels. 
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CLOSE/LOG FILE 


Closes a log file that you opened using the OPEN/LOG_FILE command. 
Use the CLOSE/LOG_FILE command to close an open log file either 
during a session at your terminal or within a command procedure. 


Privilege required: none 


CLOSE/QUEUE queue-name[:] 
Closes a print or batch queue to prevent other users from placing any 
additional PRINT or SUBMIT requests in the queue. 
Privilege required: PBSCTL 


COBOL filespec 


Compiles a COBOL-81 source program into an object program. You can 
compile only one source file at a time in COBOL-81. 


Privilege required: none 


Command Qualifiers 


/INOJANSI_FORMAT 

Indicates whether to specify that the source program format is ANSI 
COBOL instead of Digital terminal format. The default is /NOANSI_ 
FORMAT. 


[INOJCHECK 

/CHECK=[NOJBOUNDS 

/CHECK=[NOJPERFORM 

Indicates whether to enable checking for subscript and index ranges 
and nested PERFORM statements. 


/C81 
Specifies the COBOL-81 compiler. This is the default. 


/CODE[=[NO]CIS] 
Indicates whether to generate Commercial Instruction Set (CIS) code. 
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([INOJCONDITIONALS[=(AI,B,C...])] 

Indicates whether to compile conditional compilation lines. You can 
specify compilation lines with letter labels A through Z. If no lines are 
specified, all conditional compilation lines are compiled. 


/INOJCROSS_REFERENCE 
Indicates whether to include cross-reference listing in compiler listing. 
The default is /NOCROSS_REFERENCE. 


/[NOJDEBUG 
Indicates whether to include symbolic debugging information in the 
object file. The default is /NODEBUG. 


/[NOJDIAGNOSTICS[=diagfile] 
Indicates whether to generate a diagnostics file. 


ANOJLIST!=listfile] 


Indicates whether to produce an output listing file. The default is 
/NOLIST. 


AINOJMAP 
Indicates whether to generate PROCEDURE and DATA DIVISION 
maps in the LST file. This is a synonym for /SHOW=[NO]MAP. 


/NAMES=suffix 
Specifies a two-character suffix for program section names; the default 
is /NAMES=SC. 


/[NOJOBJECT{=objfile] 
Indicates whether to produce an object file. The default is /OBJECT. 


/SHOW[=[NOJMAP] 

/[INOJISHOW 

Indicates whether to generate PROCEDURE and DATA DIVISION 
maps in the LST file. The default is /NOSHOW. 


/INO|ISTANDARD option 
Specifies either V2 or 85 as the standard option. The default is 
/NOSTANDARD. 


/[NOJSUBPROGRAM 
Indicates whether to treat this program as a Sub (Main) program. The 
default is /NOSUBPROGRAM. 


/TEMPORARY=device 
Stores temporary work files on the specified device. 


DCL Commands 2-29: 


/INOTTRUNCATE 
Indicates whether to enable decimal truncation on COMP data items 
instead of binary truncation. The default is /NOTRUNCATE. 


/WARNINGS[=[NO]JINFORMATIONAL] 

/[NOJWARNINGS 

Indicates whether to enable informational diagnostics. The default is 
/WARNINGS. 


COPY [node::]input-filespec[,...] [node::Joutput-filespec 


Duplicates a file. You can: 


¢ Copy one file to another file 
¢ Merge one or more files into another file 


¢ Copy a group of files to another group of files 
Privilege required: 

¢ Create/rename access to the output file 

¢ Read access to each input file 


¢ Write access if replacing a file 


¢ SYSIO and Write access to set the privilege bit <128> in the 
protection code for non-executable files (files with the executable bit 
<64> not set). 


¢ 'TMPPRV and Write access to set the privilege bit <128> in the 
protection code for executable files (files with the executable bit 
<64> set). 


Command Qualifiers 


/ALLOCATION=n 
Preallocates n 512-byte blocks for the output file. 


/BLOCK_SIZE=n 
Specifies block size for magnetic tape output files; the valid range is 
even integers 18 to 4096. The default is /BLOCK_SIZE=512. 


2-30 DCL Commands 


/CLUSTER_SIZE=n 

Specifies the output disk file cluster size. The value of n must be a 
power of two in the range of -256 to 256, depending on the type of 
disk. The system uses the absolute value of the specified cluster size, 
or the output disk pack cluster size, whichever is greater. The default 
is the disk pack cluster size. To use clustersize optimization, specify 
/CLUSTER_SIZE=0. 


/(INOJCONFIRM 
Indicates whether to prompt before copying each file and is a synonym 
for /[NOJQUERY. 


/[INOJCONTIGUOUS 
Indicates whether to copy disk files into consecutive physical disk 
blocks. 


/BEFORE=date 

/CREATED 

/MODIFIED 

/SINCE=date 

Copies files created or modified before or since the specified date. 
/[NOJLOG N 


Indicates whether to display a confirming message for each file copied. 
The default is /LOG. 


/INOJOVERLAY 
Indicates whether to copy input file to an existing output file, replacing 
output file data with input file data. The default is /NOOVERLAY. 


/POSITION=position 
Specifies where copied files are stored on the disk; position can be: 


n Files stored at first available position after disk cluster number 
n; the default is /POSITION=0. 

INDEX Files stored at first available position after the master file 
directory index. 

MIDDLE Files stored at first available position after the middle of the 
disk. 


/PROTECTION=n 
Specifies the output file protection code. 
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/INO]JQUERY NN 
Indicates whether to prompt before copying each file. The default is 
/NOQUERY. 


/[NOJREPLACE 
Indicates whether to delete an existing file having the same file specifi- 
cation as the specified output file. The default is /NOREPLACE. 


/[NOJRETAIN_DATES 

For disk output, indicates whether to retain the creation date-time and 
access date of the input file. The default is /NORETAIN_DATES. 
=SIZE=n 

=SIZE=MINIMUMeEn 

=SIZE=MAXIMUM=n 
=SIZE=(MINIMUM=m,MAXIMUMEn) 

Selects files based on their size. The specified size can be: 


/SELECT 


n Selects only those files with size equal to n. 

MINIMUM=n Selects only those files with size greater 
than or equal to n. 

MAXIMUM=n Selects only those files with size less than 
or equal to n. 

MINIMUM=m,MAXIMUM=n Selects only those files with size between m 


and n inclusive. 


/TRANSFER_MODE={BLOCK | RECORD | AUTOMATIC} J 
Specifies which transfer mode, block or record, should be used to 
copy the file to a remote node. This qualifier only applies to network 
file copy operations (node included in either the input or output file 
specifications) and is not valid in local file copy operations. 


/TRANSFER_MODE=BLOCK copies the file as binary data consisting 
of 512-byte blocks. This mode of transfer is generally faster than record 
mode. However, it is only applicable for RSTS-to-RSTS file transfers, 
since other operating systems may not have compatible file attributes 
and blocksizes. 


/TRANSFER_MODE=RECORD copies the file as a collection of records 
based on the file record format. Although it is slower than block mode, 
record mode allows otherwise incompatible file systems to exchange 
files. This mode is recommended for file transfers involving TOPS10/20, 
ULTRIX, RT-11, and DECnet-DOS systems. 
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/TRANSFER_MODE=AUTOMATIC selects the most appropriate mode 
of transfer and is the default. 


CREATE filespec 


Opens a file so you can enter text. 

Privilege required: 

¢ Create/rename access to the file you are creating 

¢ Write access if you are replacing a file 

e SYSIO and Write access to set the privilege bit <128> in the 
protection code for non-executable files (files with the executable bit 
<64> not set). 

¢ TMPPRV and Write access to set the privilege bit <128> in the 


protection code for executable files (files with the executable bit 
<64> set). 


Command Qualifiers 


/ALLOCATION=n 
Preallocates n 512-byte blocks for a file. The default is /ALLOCATION=0. 


/CLUSTER_SIZE=n 

Specifies a file cluster size of n blocks. The value of n must be a power 
of two in the range of -256 to 256, depending on the type of disk. 

The system uses the absolute value of the specified cluster size, or 
the output disk pack cluster size, whichever is greater. The default 

is the disk pack cluster size. To use clustersize optimization, specify 
/CLUSTER_SIZE=0. 


/[NOJCONTIGUOUS 
Indicates whether to specify the file is to occupy consecutive physical 
disk blocks. The default is /NOCONTIGUOUS. 
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/POSITION=position 
Specifies the starting position of the file you are creating on the disk; 
position can be: 


n File created at first available position after the device cluster 
number (DCN) n; the range of n is 0 to the maximum DCN. 
The default is /POSITION=0. 


INDEX File created at first available position after the storage alloca- 
tion table. 

MIDDLE File created at first available position after the middle of the 
device. 


/PROTECTION=n 
Specifies the file protection code. The default is /PROTECTION=60. 


/[NOJREPLACE 
Indicates whether to delete an existing file that has the same file 
specification as the one you specify. 


CREATE/ACCOUNT [dev:][p,pn] 


Sets up a new account. 


Privilege required: GACNT or WACNT 


Command Qualifiers 


/[NOJCAPTIVE 
Indicates whether the account is to be a captive account. The default is 
/NOCAPTIVE. 


/CLUSTER_SIZE=ufd-cluster-size 
Specifies the number of 512-byte blocks in each cluster within a user 
file directory (UFD). The default is the pack cluster size. 


/DETACHED_JOB_QUOTA=detached-job-quota 
Specifies the number of detached jobs that can exist at one time for an 
account; detached-job-quota can be: 


0 to 63 Sets detached job quota 
UNLIMITED No quota enforced 


The default is /DETACHED_JOB_QUOTA=0. 
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/[NOJDIALUP 

Indicates whether to allow logins via a dial-up facility. The default is 
/DIALUP. 

/[NOJEXPIRE[=date] 

Indicates whether to expire at the end of the date specified. The default 
is /NOEXPIRE. 

/IN_QUOTA=logged-in-quota 

Specifies an account’s disk space quota (in blocks) at log in; logged-in- 
quota can be: 

0 to 16777214 Block quota 

UNLIMITED No quota enforced 


The default is IN_QUOTA=UNLIMITED. 


/INOJINTERACTIVE 
Indicates whether to allow interactive access to the account. Batch jobs 
can still run under the account. The default is INTERACTIVE. 


/JOB_QUOTA=job-quota 
Specifies the total number of jobs that can exist at one time for an 
account; job-quota can be: 


0 to 63 Sets total job quota 
UNLIMITED No quota enforced 

The default is /JOB_QUOTA=UNLIMITED. 
{INOJLOG 


Indicates whether to display an account creation message. The default 
is /LOG. 


/[LNOJLOOKUP 

Indicates whether to store passwords in a manner that follows RSTS/E 
V8.0 lookup rules. Passwords for LOOKUP accounts must be 6 char- 
acters long; passwords for NOLOOKUP accounts can be 6 to 13 
characters long. The default is /NOLOOKUP. 


/MESSAGE_QUOTA=message-quota 

Specifies the number of outstanding messages that a job running under 
this account can request when declaring itself to be a receiver. The 
range for message-quota is 0 to 65534 or UNLIMITED. The default is 
/MESSAGE_QUOTA=12. 
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/NAME="account-name" 
Specifies the account name; can be 1 to 13 characters from the ASCII 
character set whose decimal values are 9, 32 to 126, and 161 to 254. 


/[INOJINETWORK 
Indicates whether to let any network connections into this account. 
The default is /NETWORK. 


/OUT_QUOTA=logged-out-quota 

Specifies an account’s disk space quota (in blocks) at log out; logged- 
out-quota can be: 

0 to 16777214 _ Block quota 

UNLIMITED No quota enforced 


The default is /OUT_QUOTA=UNLIMITED. 


/[NOJPASSWORD_PROMPT 
Indicates whether to prompt for and require a password to log in to the 
account. The default is /PASSWORD_PROMPT. 


/POSITION=position 
Specifies where to create a UFD on a disk; position can be: 


n UFD created at first available position after 
the device cluster number (DCN) n; the range 
of nis 1 to the maximum DCN. 


INDEX UFD created as near as possible to the storage 
allocation table. 
MIDDLE UFD created as near as possible to the middle 


of the device. 
The default is /POSITION=INDEX. 


/PRIVILEGES=(privl,...]) 
Specifies the account privileges. Priv can be: 


ALL All privileges granted 
NONE All privileges denied 
Privilege keyword Specified privilege granted 


Privilege keyword with "NO" _— Specified privilege denied 
prefix 


The default is /PRIVILEGES=SETPAS. 
See Table 1-7 for a list of RSTS/E privilege keywords. 
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/RIB_QUOTAsSrib-quota 

Specifies the maximum number of receiver ID blocks (RIBs) that a job 
running under this account can set up for itself as a message receiver; 
the range for rib-quota is 0 to 256 or UNLIMITED. The default is 
/RIB_QUOTA=3. 


/SIZE=ufd-size 
SPECIFIES the initial size of a new account’s UFD expressed in 
clusters. The range of ufd-size is 1 to 7. The default is /SIZE=1. 


/TEMPLATE=dev:[p,pn] 

Indicates that the specified account’s parameters are to be used as 
defaults for the new account’s parameters. The default value for dev: 
is SY0. The default PPN is your PPN. 


/[NOJUSER 

Indicates the type of account to create. /USER means create an account 
with login attributes and file storage capabilities. /NOUSER means 
create an account for file storage only and is the default. 


CREATE/PORT [port-name] 


Creates a logical terminal port used to connect to a remote device 
connected to a terminal server. 


The port-name parameter specifies the name of the port to be created 
in the form of KBIn: or KBn: where n is a value from 0 through 127. 
If the form KBn: is used, n must be greater than the highest keyboard 
number physically attached to the system or an error will occur. If the 
port-name is not specified, the monitor will select the first available 
port and report the port-name back to the user. 


Privilege required: SWCTL 


Command Qualifiers 


/APPLICATION 

Specifies that this port is to be used for the purpose of connect- 

ing to an application terminal on a terminal server. The default is 
/APPLICATION. This qualifier is allowed only for VMS compatibility 
and will be ignored on the CREATE/PORT command. 


/LAT 
Creates a LAT port. The default is /LAT. 
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/[[NOJLOG 

Indicates whether to display a confirmation message. This is useful if 
you have not specified a port-name because the port selected will be 
displayed. The default is /LOG. 


/LOGICAL_NAME 

Assigns a user logical name to the new port. The name you assign is 
in effect until you log out, log in to another account, or deassign the 
logical name using the DEASSIGN command. 


Logical names can be up to 15 characters long. Only alphanumeric 
characters and underscores are allowed; dollar signs are allowed in 
system logical names only. Use the /SYSTEM qualifier to assign a 
systemwide logical name to the new port. The default is /USER. 


If the logical name you specify is currently assigned, then it is replaced 
by the new assignment. 


/[NOJQUEUED 

Indicates whether the connection to a terminal server will be placed on 
the server’s queue if the remote port is busy and the server supports 
queuing. If /NOQUEUED is specified and the remote port is busy, the 
connection will not be queued and it will fail. The default is /QUEUED. 


Use the SHOW PORT command to display the port’s connection status. 
If the port is set (QUEUED and the server is busy, a connection status 
of "In Progress" and the position in the queue will be shown. 


/REMOTE_PORT=remote-port-name 

Specifies the name of a remote port on the terminal server to which the 
local port is to be connected. The remote port name can be up to 16 al- 
phanumeric characters in length. This qualifier requires /TERMINAL_ 
SERVER. 


/SERVICE=service-name 

Specifies the name of a remote service offered at the terminal server 
to which the local port is to be connected. The service name can be 
up to 16 alphanumeric characters in length. This qualifier requires 
/TERMINAL_SERVER. 


/SYSTEM 
Assigns a systemwide logical name to the new port. Unlike user 
logicals, system logicals can be used by all jobs on the system. 
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System logical names are in effect until the system is shut down or you 
deassign the system logical name using the DEASSIGN command. 


If the system logical name you specify is currently assigned, then it is 
replaced by the new assignment. 


You must specify the /LOGICAL_NAME qualifier with /SYSTEM. 


/TERMINAL_SERVER=server-name 

Specifies the name of a terminal server to which the local port you 
are creating is to be assigned. The server name can be up to 16 
alphanumeric characters in length. If you use this qualifier, you must 
select a remote port or service by using /REMOTE_PORT, /SERVICE, 
or both. 


/USER 


Assigns a user logical name to the new port. The name you assign is 


in effect until you log out, log in to another account, or deassign the 
logical name using the DEASSIGN command. 


If the logical name you specify is currently assigned, it is replaced by 
the new assignment. 


You must specify the /LOGICAL_NAME qualifier with /USER. 


CREATE/SERVICE/LAT service-name 


Creates a service which is then offered by the LAT host node. The 
service-name can be up to 16 characters in length. These characters 
include the following: 

¢ The letters A through Z both upper case and lower case 

¢ The numbers 0 through 9 


¢ The dollar sign ($), the hyphen (-), the period (.), and the 
underscore (_) 


¢ The 8-bit ASCII characters from 192 to 253. 


Privilege required: SWCFG 
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Command Qualifiers 


/AIDENTIFICATION="service-id" 

Specifies a description for the service. This description is used to 
further identify the service being offered. It can be up to 64 characters 
in length. The characters include the 7-bit ASCII characters from 32 to 
126 and the 8-bit ASCII characters from 170 to 253. 


/[NOJLOG 
Indicates whether to display a confirmation message for the requested 
action. The default is /NOLOG. 


/STATIC_RATING=rating 

Specifies the static rating associated with the service. This rating 
directs terminal server users away from or toward a particular node. 
The range of values is 0 to 255. A value of 255 is highly available to 
users while a value of 0 is not available to users. The default static 
rating is 255. 


CREATE/VIRTUAL_DISK disk-size 


Reserves a section of memory for use by the virtual disk where size is 
in blocks and should be a multiple of 4. If you specify a size that is 
not a multiple of 4, it is rounded up and an informational message is 
printed. You must use the INITIALIZE and MOUNT commands, as 
with any other RSTS/E disk. 


Privileges required: HWCFG and INSTAL 


Command Qualifiers 


/ADDRESS=n 

Specifies the physical location of the memory where n is the address 
in K-words. If you do not specify this qualifier, RSTS/E selects an 
appropriate location. The default is the highest available memory. 


/[NO]LOG 
Indicates whether to display a confirmation message for the requested 
action. The default is /LOG. 
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DEALLOCATE dev[:] 


Releases a device that you reserved for private use so that other users 
may have access to the device. DEALLOCATE does not deassign any 
logical name you may have set up for the device. 


Privilege required: none 


Command Qualifier 


/ALL 
Deallocates all devices you currently have allocated. If you specify the 
device, the command deallocates the device only. 


DEASSIGN logical-name[:] 
Cancels logical name assignments you made with the ASSIGN or 
ALLOCATE commands. 


Privilege required: INSTAL to use the /SYSTEM qualifier 


Command Qualifier 


/ALL 

Cancels all user logical names that you assigned. If you also specify a 
logical name, the system cancels the specified logical name only. /ALL 
is not valid with /SYSTEM. 


/SYSTEM 
Deassigns a systemwide logical name. 


/USER 
Deassigns a user logical name. /USER is the default. 


DEASSIGN/PORT port-name[:] 


Deassigns a local LAT port on the RSTS/E node from the remote 
terminal server to which it was assigned. 


The port-name is the local port which will be deassigned. The port- 
name must be in the form of KBIn: or KBn: where n is a value from 0 
through 127. 
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Privilege required: SWCFG 


Command Qualifier 


/LAT 
Deassigns a LAT port. The default is /LAT. 


/[NOJLOG 
Indicates whether to display a confirmation message. The default is 
/LOG. 


DEASSIGN/QUEUE queue-name[:] server-name[:] 


Deassigns a server or all servers from a queue. Any job already started 
on a deassigned server is not affected. 


Privilege required: PBSCTL 


Command Qualifier 


/ALL 
Deassigns all servers currently assigned to the queue. If you specify 
/ALL and a server-name, PBS deassigns the server-name only. 


DEFINE/COMMAND/SYSTEM command-name program-filespec 


Defines a system (CCL) command. 


Privilege required: INSTAL 


Command Qualifiers 


/LINE_NUMBER<sentry-point 
Defines the entry point in the command program. The valid range for 
entry-point is 0 to 32,767. Other values for entry-point are: 


CCL 30,000 
CHAIN 31,000 
DCL 30,500 


The default is /(LINE_.NUMBER=0. 
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/[NOJPRIVILEGE 
Indicates whether to retain program temporary privileges. The default 
is /NOPRIVILEGE. 


/[NOJREPLACE[=QUERY] 

Indicates what action to take if the system command specified is 
already defined. /NOREPLACE returns an error message if the system 
command is already defined. /REPLACE replaces the existing system 
command with the new definition. /REPLACE=QUERY prompts you 
to replace the existing system command with the new definition if the 
system command already exists. The default is /NOREPLACE. 


DELETE [node::ifilespecf,...1 


Deletes a disk file on a local or remote node. 


Privilege required: Write access to each file you want to delete 


Command Qualifiers 


/BEFORE=date 

/CREATED 

/MODIFIED 

/SINCE=date 

Deletes files you created or modified before or since the specified date. 
The default is /CREATED. 


/[NOJCONFIRM 

Indicates whether to display each file specification and prompt before 
deleting that file. (INO]JCONFIRM is a synonym for [NO]JQUERY. The 
default is /NOCONFIRM. 


/ERASE 
Zeros the file before deleting it. 


/[NOJLOG N 
Indicates whether to display a confirmation message for each file 
deleted. The default is /LOG. 


/INO]QUERY N 
Indicates whether to display each file specification and prompt before 
deleting that file. The default is /NOQUERY. 
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=SIZE=n 

=SIZE=MINIMUM=n 

=SIZE=MAXIMUM=n 
=SIZE=(MINIMUM=m,MAXIMUM=n) 
Selects files based on their size. The specified size can be: 


/SELECT 


n Selects only those files with size equal to n. 

MINIMUM=en Selects only those files with size greater 
than or equal to n. 

MAXIMUM=n Selects only those files with size less than 


or equal to n. 
MINIMUM=m,MAXIMUM=en Selects only those files with size between m 


and n inclusive. 


/[NOJWARNINGS 
Indicates whether to display an error message if the specified files are 
not found. The default is /WARNINGS. 


DELETE/ACCOUNT [dev:][p,pn] 


Deletes an account from a disk. 
Privilege required: 
e¢ GACNT or WACNT 


© GWRITE or WWRITE 
e SYSIO to delete an account in [0,*] 


Command Qualifiers 


/INO]CONFIRM 
Indicates whether to prompt before deleting the account and is a 
synonym for /[NOJQUERY. The default is /NOCONFIRM. 


/[NOJLOG 
Indicates whether to display a confirmation message after deleting an 
account. The default is /LOG. 


/[NOJPURGE[=QUERY] 

Indicates whether to delete files and the account. QUERY prompts 
for permission to continue if the account contains files. The default is 
/PURGE=QUERY. 
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[INO]JQUERY 

Indicates whether to prompt before deleting the account. If you specify 
/NOQUERY, the system prompts only if the account has nonzero 
accounting data. The default is /NOQUERY. 


ANOJRESET[=QUERY] 

Indicates whether to delete the account if accounting data is nonzero. 
QUERY prompts for permission to continue if the accounting data is 
nonzero. The default is /RESET=QUERY. 


/INOJUSER 
Restricts deletions to accounts of a specific type (user or nonuser). The 
default is to search all accounts. 


Deletes a command from the list of defined systemwide commands. 


Privilege required: INSTAL 


Command Qualifier 


/ALL 
Deletes all systemwide commands. If you also specify a command, the 
system deletes the specified command only. 


DELETE/ENTRY {entry-spec | entry-number 


Deletes one or more job entries from a print or batch queue. 
Privilege required: 

¢ GACNT to delete a job of another owner in your group 

¢ WACNT to delete a job of another owner not in your group 
Command Qualifiers 


/BATCH 
Deletes batch queue entries only. 


/PRINT 
Deletes print queue entries only. 


DCL Commands 2-45 


DELETE/PORT port-name[:] 


Deletes a logical terminal port that was created by the CREATE/PORT 
command. If the port has an active session, then the port is not deleted 
until the session is completed. 


The port-name parameter specifies the name of the port to be in the 
form of KBI n: or KBn: where n is a value between 0 and 127. The 
port must have already been created by the CREATE/PORT command. 
If the form KBn: is used, then n must be greater than the highest 
keyboard number physically connected to the system or an error will 
occur. 


Privilege required: SWCTL 


Command Qualifiers 
(AINOJABORT 


Indicates whether to abort the connection if the port is in use. 
Specifying /ABORT terminates the current session, if any, and deletes 
the port. Specifying /NOABORT marks the port for deletion and deletes 
it when the current session is finished. The default is /NOABORT. 


/LAT 

Deletes a LAT port. The default is /LAT. 

/[NOJLOG 

Indicates whether to display a confirmation message. The default is 
/LOG. 


DELETE/QUEUE queue-name[:] 


Deletes a print or batch queue. 
Privilege required: SWCFG 


DELETE/SERVER server-name{:] 


Deletes a print or batch server. 


Privilege required: SWCFG 
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DELETE/SERVICE/LAT service-name 


Deletes a service currently offered by the LAT host node. 
Privilege required: SWCFG 


Command Qualifier 


/[NOJLOG 
Indicates whether to display a confirmation message for the requested 
action. The default is /NOLOG. 


DELETE/SYMBOL symbol-name 
Deletes one or more DCL symbols from your local or global symbol 
table. 


Privilege required: none 


Command Qualifiers 


/ALL 
Deletes all symbols. If you also specify a symbol name, the system 
deletes the specified symbol only. 


/GLOBAL 
Deletes the specified symbol from the global symbol table. This is the 
default for the interactive command level. 


/LOCAL 
Deletes the specified symbol from the local symbol table. This is the 
default for all command levels except interactive. 


DELETE/VIRTUAL_DISK 


Deletes the virtual disk. You cannot delete the virtual disk if it is 
mounted, assigned, or has open files. 


Privileges required: HWCFG and INSTAL 
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Command Qualifiers 


/[NOJLOG 
Indicates whether to display a confirmation message for the requested 
action. 


DETACH job-number 


Detaches a job from its terminal. 
Privilege required: JOBCTL to detach jobs in other accounts. 


Command Qualifier 


/INOJCLOSE 
Indicates whether to close all nonzero channels on which the job’s 
terminal is open before detaching. The default is /CLOSE. 


DIBOL filespecf,...] 


Compiles up to six DIBOL-11 source files into a single object file. 


Privilege required: Read access to the files you are compiling. 


Command Qualifiers 


/[NOJDEBUG 

Indicates whether to direct the compiler to use the DIBOL Debugging 
Technique (DDT) when you run the program. The default is 
/NODEBUG. 


ANOJLIST[=listfile] 
Indicates whether to generate an output listing file. The default is 
/NOLIST. 


[INOJOBJECT{[=objfile] 
Indicates whether to produce an output object file. You can specify the 
object file name. The default is /OBJECT. 


/[NOJOPTIMIZE 
Indicates whether to produce optimized code. The default is 
/NOOPTIMIZE. 
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/INOJSTANDARD[=ANSI | D83] 

Specifies the syntax that the DIBOL compiler will accept. Specifying 
/STANDARD or /STANDARD=ANSI telis the compiler to accept ANSI 
DIBOL syntax. Specifying /STANDARD=D83 tells the compiler to 
accept DIBOL-83 syntax. The default is /NOSTANDARD. 


/INOJTWARNINGS 
Indicates whether to produce diagnostic messages for warning condi- 
tions. The default is /WARNINGS. 


DIFFERENCES input-filespec compare-filespec 


Compares two text files and lists any sections of text that differ. 
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¢ Read access to the files you are comparing 
¢ Write access to any output file you create 
Command Qualifiers 


/AIGNORE=BLANK_LINES 
Ignores blank lines while comparing files. 


/MATCH=size 
Specifies the number of lines that must be identical to constitute a 
match. The default is /MATCH=3. 


/MAXIMUM_DIFFERENCES=n 
Specifies the maximum number of differences before terminating 
comparison. The default is /MAXIMUM_DIFFERENCES=300. 


/OUTPUT=filespec 
Writes the comparison output to a file. The default is to write the 
output on your terminal. 


DIRECTORY [node::][filespec{,...]] 


Displays information about files. 
Privileges required: 


¢ None for files in your own account 
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¢ Read or execute access for files not in your account 


Command Qualifiers 


/BEFORE=date 

/CREATED 

/MODIFIED 

/SINCE=date 

Lists files created or modified before or since the specified date. The 
default is /CREATED. 


/BRIEF fN 
Lists only the file name and type of each file. The default is /BRIEF. 


/INO]DATE[=ALL | CREATED | MODIFIED] 
Indicates whether to display creation date and time or date of last 
access or both. The default is /NODATE. 


/FULL 

Displays each file’s file name and type, size in blocks, protection code, 
date last accessed or modified, date and time created, cluster size, run- 
time system name, position of first block on disk, and file attributes 
including IGNORE and BACKUP. The default is /BRIEF. 


/OUTPUT=filespec 
Creates a file containing the output of a DIRECTORY listing, instead 
of displaying the output at your terminal. 


/[INOJPROTECTION 
Indicates whether to include protection codes in listing. The default is 
/PROTECTION. 


=SIZE=n 

=SIZE=MINIMUM=n 

=SIZE=MAXIMUM=n 
=SIZE=(MINIMUM=m,MAXIMUME=n) 
Selects files based on their size. The specified size can be: 


/SELECT 


n Selects only those files with size equal to n. 

MINIMUM=n Selects only those files with size greater 
than or equal to n. 

MAXIMUM=n Selects only those files with size less than 


or equal to n. 


MINIMUM=m,MAXIMUM=n Selects only those files with size between m 
and n inclusive. 


2-50 DCL Commands 


If you specify /SELECT together with the /SIZE=ALLOCATION quaii- 
fier, files are selected based on allocated size. 


/[NOJSIZE[=ALLOCATION | USED] 
Indicates whether to display the blocks allocated or used for a file. The 
default is /SIZE=USED when you specify /SIZE with no argument. 


‘TOTAL N 
Displays the total amount of space your files require, without listing 
information about each file. 


(For disks) DISMOUNT disk-device-name[:] [pack-id] 


Releases a disk you previously mounted using the MOUNT command. 
DISMOUNT also deallocates the device if it was allocated to you. 


Privilege required: 

¢ None for disk drives that you own 

¢ MOUNT for disk drives mounted /SHARE or /NOSHARE by others 
Command Qualifier 


/PUBLIC 
Dismounts a public disk drive. You must have MOUNT privilege to 
dismount a public disk drive. 


(For tapes) DISMOUNT tape-device-name[:] [label] 


Releases a tape you previously mounted using the MOUNT command. 
DISMOUNT also deallocates the device if it was allocated to you. 


Privilege required: none 
Command Qualifier 


/INOJUONLOAD 
Indicates whether to unload the tape from the drive. The default is 
/UNLOAD. 
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DUMP/SYSTEM 


Records the current state of the system in the CRASH.SYS file. 
Privilege required: SYSIO 


EDIT filespec 


Starts the EDT text editor program, which lets you create and edit text 
files. 

Privilege required: 

¢ Create/rename access to a file you create 

¢ Read/write access to a file you modify 

¢ Read access to a file you are reading ((-READ_ONLY) 


Command Qualifiers 


/INOJCOMMAND[=filespec] 

Indicates whether to read and execute the commands in a com- 
mand file before beginning the editing session. The default is 
/COMMAND=EDTINI.EDT. 


/[NO]JCREATE 
Indicates whether to open a new file when the specified does not exist. 
The default is /CREATE. 


/EDT 
Makes sure that the EDIT command starts EDT. 


/FORMAT=(STREAM | VARIABLE} 
Specifies that the file format is stream ASCII or variable-length. The 
default is /FORMAT=STREAM. 


[NO)|JOURNAL[=filespec] 
Indicates whether to create a journal file for the editing session. The 
default is /JOURNAL. 


/[INOJOUTPUT{[=filespec] 
Indicates whether to define the file specification of the file created 
during the editing session. The default is /OUTPUT. 
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$EOD 


/[NOJREAD_ONLY 
Indicates whether to disable journaling and the creation of an output 
file when you view a file. The defauit is /NOREAD_ONLY. 


/INOJRECOVER 
Indicates whether to read commands from a journal file before starting 
the editing session. The default is /NORECOVER. 


Signals the end of a data list and exits from a program within a 
command procedure. The dollar sign ($) is required. 


Privilege required: none 


EXIT [status-code] 


Ends the current-level command procedure and returns control to the 
next higher command level. 


Privilege required: none 


FORCE destination[,...] "string" 


Forces a string to the specified users or terminals; destinations can be 
PPNs that include wildcard characters or keyboard device specifica- 
tions. You must specify a destination, or use the /ALL or /LOGGED_IN 
qualifiers. 


Privilege required: SYSIO 


Command Qualifiers 


/ALL 
Forces the string to all terminals. You cannot specify a destination 
with /ALL. 


/LOGGED_IN 
Forces the string to all logged-in terminals. You cannot specify a 
destination with /LOGGED_IN. 
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FORTRAN {/F77 | /FOR} filespecf,...] 


Invokes the FORTRAN compiler for up to six FORTRAN source files. 
/F77 invokes FORTRAN-77 and /FOR invokes FORTRAN-IV. The 
default is /F77 unless your system manager changes it. 


Privilege required: 
¢ Read access to the files you compile 
e Create/rename access to any files you create 


FORTRAN/F77 Qualifiers 


/[INO]JCHECK 
Indicates whether to produce extra code to check for program correct- 
ness at run time. The default is /CHECK. 


/CONTINUATIONS=n 
Specifies the maximum number of continuation lines permitted. The 


valid range for n is any decimal number from 0 to 99. The default is 
/CONTINUATIONS=19. 


/[NO]D_LINES 
Indicates whether to read and compile debugging lines. The default is 
/NOD_LINES. 


/(NOJDEBUG 

Indicates whether to direct the compiler to provide symbol table infor- 
mation for use by the PDP-11 FORTRAN-77 symbolic debugger. When 
you specify /DEBUG, you should also use the /NOOPTIMIZE qualifier. 
The default is /NODEBUG. 


/[NOJI4 

Determines how the compiler interprets INTEGER and LOGICAL 
declarations that do not specify a length. /NOI4 causes the compiler to 
interpret the declarations as INTEGER2 and LOGICAL2. /14 allocates 
two words (four bytes) for the default length of integer and logical 
variables. The default is /NOI4. 


/[NOJIDENTIFICATION 

Indicates whether to display the FORTRAN-77 compiler identi- 
fication and version numbers on your terminal. The default is 
/NOIDENTIFICATION. 
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ANOJLIST[=listfile] 
Indicates whether to create a listing file. The default is /NOLIST. 
/[INOJMACHINE_CODE 


Indicates whether to include machine language code in the listing file. 
The default is /NOMACHINE_CODE. 


/[NOJOBJECT[=objfile] 
Indicates whether to create an object output file. The default is 
/OBJECT. 


/INOJOPTIMIZE 

Indicates whether to preduce optimized code. The default is 
/OPTIMIZE. 

/INOJSTANDARD[=ALL i SOURCE i SYNTAX] 
Indicates whether to check your source code for extensions 
standard FORTRAN at the full-language level, where: 

ALL Checks for all extensions 

SOURCE Checks for lowercase ietters and tab characters 


SYNTAX Checks for syntax extensions 
The default is /NOSTANDARD. 


/INOJWARNINGS 
Indicates whether to produce diagnostic messages for warning condi- 
tions. The default is /WARNINGS. 


/WORK_FILES=n 

Specifies the number of temporary disk work files used during compila- 
tion. The valid range for n is 1 to 3. The default is 

/WORK_FILES=2. 


FORTRAN/FOR Qualifiers 


/CODE={EAE | EIS | FIS | THR} 

Selects either EAE, EIS, or FIS hardware or threaded code. 
/INOJD_LINES 

Indicates whether to read and compile debugging lines. The default is 
/NOD_LINES. 


/[NOJEXTEND_SOURCE 
Indicates whether to allow source lines to contain significant characters 
in columns 73 through 80. The default is /NOEXTEND_SOURCE. 


DCL Commands 2-55 


/[NOJI4 

Determines how the compiler interprets INTEGER and LOGICAL 
declarations that do not specify a length. /NOI4 causes the compiler to 
interpret the declarations as INTEGER2 and LOGICAL2. /14 allocates 
two words (four bytes) for the default length of integer and logical 
variables. The default is /NOI4. 


/[NOJLINE_NUMBERS 

Indicates whether to include internal sequence numbers in the exe- 
cutable program for routine diagnostics. The default is 
/LINE_NUMBERS. 

ANOJLIST[=listfile] 

Indicates whether to create a listing file. The default is /NOLIST. 
/INOJMACHINE_CODE 

Indicates whether to include machine language code in the listing file. 
The default is /NOMACHINE_CODE. 

/([INOJOBJECT{[=objfile] 

Indicates whether to create an object output file. The default is 
/OBJECT. 


/[INOJOPTIMIZE 
Indicates whether to produce optimized code. The default is 
/OPTIMIZE. 


/[INOJWARNINGS 
Indicates whether to produce diagnostic messages for warning condi- 
tions. The default is /(WARNINGS. 


GOSUB label-name 


Passes control to a labeled subroutine in a command procedure (not 
valid at interactive level). 


Privilege required: none 
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GOTO label-name 


Passes control to the labeled line in a command procedure (not valid at 
interactive level). 


Privilege required: none 


HANGUP KB{[c]n[:] 
Disconnects a dial-up terminal by dropping the carrier signal line. 
Privilege required: HWCTL 


HELP topic [subtopic [subsubtopic [...]]] 
Displays information about DCL commands and RSTS/E. 
Privilege required: none 
Command Qualifiers 


/OUTPUT=filespec 
Writes the information to the specified file. 


/[NOJPROMPT 
Indicates whether to enable topic and subtopic prompting. 


IF expression THEN [$] command 
Tests the value of an expression and executes the DCL command 


following the THEN keyword if the result of the expression is true. An 
expression is true if the value is odd. 


Privilege required: none 


(For disks) INITIALIZE disk-device-name[:] pack-id 


Creates a RSTS/E file structure on a disk. 
Privilege required: RDNFS and WRTNFS 


DCL Commands 2-57 


Command Qualifiers 


/CLUSTER_SIZE=n 

Specifies the pack cluster size, which is the minimum allocation unit, 
in 512-byte blocks, for the disk. The valid values for n are 1, 2, 4, 8, 16, 
32, and 64. The default is the device cluster size. 


/DATE={ACCESSED | MODIFIED} 
Maintain files by their date of last access or last modification. The 
default is /DATE=MODIFIED. 


/[[NOJERASE 
Indicates whether to erase data on the specified disk. The default is 
/ERASE. 


/[NOJEXERCISE=n 
Indicates whether to check for bad blocks on the disk. The valid values 
for n are 0, 1, 2, 3 and FULL. The default is /EXERCISE=FULL. 


/INDEX=position 
Specifies where the SATT.SYS file is located on the disk; position can 


be: 

n File located at device cluster n; valid values for n are 1 
to the total device size divided by the device clustersize. 

BEGINNING File located at the beginning of the disk. 

MIDDLE File located at the middle of the disk. 


The default is /INDEX=MIDDLE. 


/MFD_CLUSTER_SIZE=n 

Specifies the minimum allocation unit, in 512-byte blocks, for the 
Master File Directory (MFD). The valid values for n are 4, 8, or 16, 
which must be greater than or equal to the value entered for the 
CLUSTER_SIZE qualifier (but no larger than 16). The default is 
/MFD_CLUSTER_SIZE=16. 


/NEW_FILES={FIRST | LAST} 

Specifies whether files stored on the disk will be placed at the begin- 
ning of an account (/NEW_FILES=FIRST) or at the end of an account 
(/NEW_FILES=LAST). The default is /NEW_FILES=LAST. 

/PRIVATE 

Allows disk access only to users having an account on the disk. 
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/PUBLIC 
Allows disk access to all users having an account on the system. The 
default is /PRIVATE. 


/INOJQUERY 

Indicates whether to request permission to continue when you select 
a disk for initialization that already has a RSTS/E file structure. The 
default is /QUERY. 


/INOJRETAIN 
Indicates whether to use the existing bad block file. The default is 
/RETAIN. 


/[NOJWRITE 
Indicates whether to allow read/write access instead of read-only access 
when you mount the disk. The default is (WRITE. 


(For tapes) INITIALIZE tape-device-name[:] [label] 


Writes a new label on a tape and allocates the tape drive if it is not 
already allocated. 


Privilege required: DEVICE if the tape drive is restricted 


Command Qualifiers 


/DENSITY=n 

Specifies the density in bits per inch (bpi). Depending on the tape drive, 
n can be in the range 2 to 32766. Currently available densities are 800, 
1600, 6250, 6667, and 10000 bpi. You can also specify MINIMUM 

or MAXIMUM, which causes the system to set the density to the 
minimum or maximum the tape drive supports. 


Any density you specify overrides the system default density. 


If you do not specify a density, INITIALIZE uses the system default 
density. If the system default density is not valid for the tape drive, 
the system selects the next higher density the tape drive supports. If 
the system default density is higher than the highest density the drive 
supports, the system selects the tape drive’s maximum density. 


When you specify a density that the tape drive does not support, you 
receive an error message. 


DCL Commands 2-59 


/FORMAT={ANSI | DOS} 
Specifies the tape label format. 


INITIALIZE/QUEUE queue-name[:] 


Defines a print or batch queue. 
Privilege required: SWCFG 


Command Qualifiers 


/BATCH 
Specifies that you are initializing a batch queue. 


/CLOSE 
Initially closes the queue. 


/CPU_LIMIT=(MAXIMUM<=a, DEFAULT=b) 

/ CPU_LIMIT=n 

Specifies the maximum and/or default CPU time limits (in minutes) you 
can specify when submitting a job to the queue. If you use the /CPU_ 
LIMIT=n form, n specifies both the maximum and default limits. The 
valid range for a, b, and n is 1 to 65535 in addition to UNLIMITED. 
The default value cannot exceed the maximum value. 


/DEFAULT 
Initializes the default queue. 


/FORMS=form-name 
Specifies the name of the default forms for a print queue. 


/PAGE_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/PAGE_LIMIT=n 

Specifies the maximum and/or default page limits a user can specify 
when submitting a job to the queue. If you use the /PAGE_LIMIT=n 
form, n specifies both the maximum and default limits. The valid 
range for a, b, and n is 1 to 4294967295 in addition to UNLIMITED. 
The default value cannot exceed the maximum value. The default is 
/PAGE_LIMIT=UNLIMITED. 


/PRINT 
Initializes a print queue. 
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/PRIORITY=(MAXIMUM=a,DEFAULT=b) 

/PRIORITY=n 

Specifies the maximum and/or default priorities a user can specify 
when submitting a job to the queue. If you use the /PRIORITY=n form, 
n specifies both the maximum and default limits, The valid range for 


a, b, and n is 1 to 255. The default value cannot exceed the maximum 
value. The default is /PRIORITY=255. 


/PRIVILEGES=(privi,...]) 
Specifies the set of privileges a user must have to enter jobs in queue. 


Priv can be: 

ALL All privileges granted 

NONE All privileges denied 

Privilege keyword Specified privilege granted 

Privilege keyword with "NO" Specified privilege denied 

prefix 

The default is /(PRIVILEGES=NONE. See Table 1-7 for a list of RSTS/E 
privilege keywords. 


/TIME_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/TIME_LIMIT=n 

Specifies the maximum and/or default elapsed time limits (in minutes) 
you can specify when submitting a job to the queue. If you use the 
/TIME_LIMIT=n form, n specifies both the maximum and default 
limits. The valid range for a, b, and n is 1 to 65535 in addition to 
UNLIMITED. The default value cannot exceed the maximum value. 
The default is /TIME_LIMIT=UNLIMITED. 


INITIALIZE/SERVER server-name[:] 
Defines a print or batch server. 
Privilege required: SWCFG 


Command Qualifiers 


/[LNOJCONTROLS[=UP_ARROW] 
Indicates how print servers handle control characters and escape 
sequences. The default is /CONTROLS=UP_ARROW. 
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/FORMS=form-name 
Specifies the name of the forms installed on the printer. 


/PRIORITY=n 

Specifies the priority at which command procedures controlled by this 
batch server run. The valid range for n is -120 to 120. PBS rounds the 
priority down to the nearest multiple of 8. You cannot specify a priority 
that exceeds the PBS job priority. The default is /PRIORITY=-8. 


/RUN_BURST=n 
Specifies the run burst assigned to any command procedure controlled 


by this batch server. The valid range for n is 1 to 127. The default is 
/RUN_BURSTS=6. 


/INO|JSHAREABLE 
Indicates whether to share the server’s device with other jobs on the 
system. The default is /SHAREABLE. 


INQUIRE symbol-name ["prompt-string"] 


Prompts for a value at your terminal and waits for a response. After 
you enter a response, INQUIRE assigns the value as a string to the 
specified symbol name. If you do not specify a prompt string, DCL uses 
the symbol name to prompt for the value. 


Privilege required: none 


Command Qualifiers 


(INOJECHO 
Indicates whether to display responses to prompts on your terminal. 
The default is /ECHO. 


/EXIT[=label] 
Specifies the action taken when you type CTRL/Z. Passes control to 
label, otherwise exits. The default is /EXIT. 


/GLOBAL 
Places the specified symboi in the giobal symboi table. The default is 
/LOCAL. 


/LOCAL 
Places the specified symbol in the local symbol table for the current 
command procedure. 
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/[NOJPUNCTUATION 
Indicates whether to append a colon (:) and space to the displayed 
prompt string. The default is /PUNCTUATION. 


/TIME_OUT=n 
The amount of time (in seconds) the system waits for a response before 
continuing without changing the symbol name value. 


INSTALL/ERROR_FILE [filespec] 
Installs the specified file as the system error message file. If you do not 
specify a file, the default file SY0:[0,1JERR.SYS is used. 
Privilege required: 
¢ INSTAL 
¢ Write access to the error file 


Command Quaiifiers 
/[NOJLOG 


Indicates whether to display a confirmation message after installing 
the error file. The default is /LOG. 


/POSITION=position 
Places the error file at the specified position on the disk; position can 


be: 

n Places the error file at first available position after the device 
cluster number (DCN) n; the range of n is 0 to the maximum 
DCN. 

INDEX Places the error file at the first available position after the 
storage allocation table. 

MIDDLE Places the error file at the first available position after the 


middle of the device. 
The default is /POSITION=0. 


/SIZE=n 
Creates an error file if one does not exist and allocates n blocks to the 
file. 
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INSTALL/LIBRARY library-name 


Adds the specified library as a resident library in memory. 
Privilege required: 

e INSTAL 

¢ Read access to the library file 


Command Qualifiers 


/[[NOJADDRESS[=n] 

Specifies the memory address where you want to load the resident 
library. The valid range for n is 1K to 2043K. /NOADDRESS causes 
the system to compute a new starting address each time it loads the 
library. The system places the library in the highest part of memory 
when you specify /ADDRESS. The default is /ADDRESS. 


/NOADDRESS[=RESTRICTED] 
The restricted argument allows installation of size-restricted floating 
libraries. 


/NOADDRESS=UNRESTRICTED 
The unrestricted argument allows installation of unrestricted floating 
libraries. 


/[NOJERROR_LOGGING 
Indicates whether to log library errors. The default is /ERROR_ 
LOGGING. 


/[NOJLOCK 
Indicates whether to lock the resident library in memory. The default 
is /NOLOCK. 


/PROTECTION=n 

Specifies the protection code you want to assign to the resident library. 
The valid range for n is 0 to 63. The default is /PPROTECTION=42. 
/[NOJREAD_ONLY 

Determines whether you want to allow read only or read and write 
access to the library. The default is /READ_ONLY. 


/[NOJISHAREABLE 
Indicates whether to allow one or more than one user to access the 
library at the same time. The default is /SHAREABLE. 
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/[NOJUNLOAD 
Indicates whether to remove the resident library from memory when it 
is not in use. The default is /NOUNLOAD. 


INSTALL/OVERLAY_FILE [filespec] 
Installs the file you specify as the system overlay file. If you do not 
specify a file, the default file SY0:[0,1JOVR.SYS is used. 
Privilege required: 
* INSTAL 
¢ Write access to the overlay file 
Command Qualifiers 
/[NO]JLOG 
Indicates whether to display a confirmation message after installing 
the overlay file. The default is /LOG. 


/POSITION=position 
Places the overlay file at the specified position on the disk; position can 


be: 

n Places the file at the first available position after the device 
cluster number (DCN) n; the range of n is 0 to the maximum 
DCN. 

INDEX Places the file at the first available position after the storage 
allocation table. 

MIDDLE Places the file at the first available position after the middle of 
the device. 

The default is /POSITION=0. 

/SIZE=n 

Creates an overlay file if one does not exist and allocates n blocks to 

the file. 
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INSTALL/RUNTIME_SYSTEM name 


Installs the specified run-time system in memory. 
Privilege required: 

e INSTAL 

e Read access to the runtime system file 


Command Qualifiers 
AINOJADDRESS[=n] 


Specifies the memory address where you want to load the run-time 
system. The valid range for n is 1K to 2043K. The system places 

the run-time system in the highest part of memory when you specify 
/ADDRESS. The system computes a new starting address each time it 
loads the run-time system when you specify /NOADDRESS. The default 
is /NOADDRESS. 


/[[NOJERROR_LOGGING 
Indicates whether to log run-time system errors. The default is 
/ERROR_LOGGING. 


/INOJKEYBOARD_MONITOR 
Indicates whether to install the run-time system as a keyboard monitor. 
The default is /NOKEYBOARD_MONITOR. 


/[NOJLOCK 
Indicates whether to lock the run-time system in memory. The default 
is /NOLOCK. 


/MAXIMUM_SIZE=n 
Specifies the maximum job size you want to allow a job running under 
this run-time system. The valid range for n is 1K to 28K. 


/MINIMUM_SIZE=n 
Specifies the minimum job size you want to allow a job running under 
this run-time system. The valid range for n is 1K to 28K. 


/POSITION=n 

Places the run-time system block at position n after the primary run- 
time system in the linked list; the valid range for n is 0 to 255. If you 
do not specify this qualifier, the system places the run-time system at 
the end of the list. 


2-66 DCL Commands 


/PREFIX[=n] 

Specifies the prefix code the system uses for emulator traps. The valid 
range for n is 0 to 255. The defauit is /PREFIX=255. 
/[NOJREAD_ONLY 


Determines whether to allow read-only or read/write access to the 
run-time system. The default is /READ_ONLY. 


/[INO]ISHAREABLE 

Indicates whether to allow one or more than one user access to the 
run-time system. The default is /SSHAREABLE. 

/TYPE=filetype 

Specifies the default file type for programs that execute under this 
run-time system. 


ITATSNITTATT XAT 
JUAN JUIN, 


Indicates whether to remove the run-time system from memory when it 
is not in use. The default is /NOUNLOAD. 


INSTALL/SWAP_FILE [=]index [filespec] 


Installs the specified file as a swap file. The index value can be 0, 1, or 
3. If you do not specify a file, the default file SY0:[0,1J]SWAPn.SYS is 
used, where n is the index value. 

Privilege required: 

e INSTAL 

¢ Write access to the swap file 


Command Qualifiers 


/DEVICE=disk-name[:] 

Specifies that the disk is to be used exclusively as a non-file-structured 
swapping disk. Any data or structure on the disk is destroyed when 
jobs are swapped to it. You cannot use the /DEVICE qualifier with the 
filespec parameter, or with the /POSITION or /SIZE qualifiers. 


/[NOJLOG 
Indicates whether to display a confirmation message after installing 
the swap file. The default is /LOG. 
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/POSITION=position 
Places the file at the specified position on the disk; position can be: 


n Places the error file at first available position after the device 
cluster number (DCN) n; the range of n is 0 to the maximum 
DCN. 

INDEX Places the file at the first available position after the storage 
allocation table. 

MIDDLE Places the file at the first available position after the middle of 
the device. 

The default is /POSITION=0. 

/SIZE=n 

Creates a swap file if one does not exist and allocates n blocks to the 

file. 


LINK filespecf,...] 


Combines one or more object files to produce an executable program. 
You can also specify an overlay structure for the program. 

Privilege required: 

¢ Read access for the programs you are linking 

¢ Create/rename access to any files you create 


Language Qualifiers 


/BASIC 

/BP2 

Links BASIC-PLUS-2 object files. If you do not specify a language 
qualifier, RSTS/E assumes BASIC-PLUS-2 unless your system manager 
changes it. 


/CC 
Links PDP11-C object files. 


/COBOL 
/C81 
Links COBOL-81 object files. 


/DIBOL 
Links DIBOL object files. 


2-68 DCL Commands 


/FTT 
Links FORTRAN-77 object files. 


/FOR 
Links FORTRAN-IV object files. 


/RSX11 
Links object files produced by the RSX-based MACRO assembler 
(MAC.TSK). 


/RT11 
Links object files produced by the RT11-based MACRO assembler 
(MACRO.SAV). 


Command Qualifiers 


/CODE=[NOIDATA_SPACE 

Indicates whether to create an instruction and data (I&D) space task. 
You cannot use this qualifier with the /FOR or /RT11 qualifiers. The 
default is /CODE=NODATA_SPACE. 


/INOJDEBUG 
Indicates whether to invoke the debugger associated with a program- 
ming language. The debugging tools are: 


COBOL-81 Symbolic Debugger 

DIBOL DDT (DIBOL Debugging Technique) 
FMS Debug mode 

MACRO ODT (Octal Debugging Technique) 
The default is /NODEBUG. 

/DESCRIPTION 


Indicates that the input file is a Task Builder command file that 
describes how to link the program. 


/[NOJDMS 
Indicates whether to link your DIBOL program with Data Management 
Services (DMS) instead of RMS. The default is /NODMS. 


/[NOJEXECUTABLE[=filespec] 
Indicates whether to produce an executable file. The default is 
/EXECUTABLE. 
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/[NOJFMS[=[NOJRESIDENT] 

Indicates whether to link your program with the Forms Management 
System (FMS) and Indicates whether to use the resident library instead 
of the disk library. The default is /NOFMS. 


/[LNOJMAP[=filespec] 
Indicates whether to produce a memory map file. The default is 
/NOMAP. 


/OTS=[NOJRESIDENT 
Specifies the resident library or the disk library for the language Object 
Time System (OTS). 
=[NOJRESIDENT 
/[NOJRMS =SUPERVISOR 


=USER 
Indicates whether to link your program with the Record Management 


Services (RMS) and when using the SUPERVISOR or USER argument 
specifies which hardware mode the resident library should use. The 
default is /RMS. 


/SORT_AND_MERGE=[NO]JRESIDENT 
Indicates whether to use the SORT/MERGE clustered resident library 
instead of the disk library in the user task. 


/STACK=n 
Resets the allocation of stack space. 


/STRUCTURE 
Prompts you for an overlay structure. 


LOAD/INDEX [dev{[:]] 


Loads the SAT (Storage Allocation Table) for a disk device into memory 
during timesharing. By making the SAT resident in memory, you can 
improve the system’s performance at the cost of increased memory 


(XBUF) usage. 
If you do not specify a device, the default is the system disk (SY0:). 
Privilege required: SWCTL 
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LOAD/OVERLAY overlay-namef....] 


Loads one or more monitor overlays into memory. Overlay-name can 


be: 

ATTRIBUTE Performs file and account attribute read/write 
operations. 

DCL Performs file-related operations for DCL. 

DELETE_RENAME Performs file deletion and renaming. 

DIRECTORY Performs disk file lookup operations. 

FILE_UTILITY Performs the monitor file utility functions. 

SYSTEM_CALLS Performs the following monitor directives: 


e Gets monitor tables (parts 1, 2, and 3) 
e Returns open file information 

¢ Converts dates and times 

¢ Returns job status 


TERMINAL Performs the set termina] characteristics and the 
hangup terminal directives. 


Privilege required: SWCFG 


Command Qualifier 


/ALL 
Loads all monitor overlays into memory. If you also specify an overlay 
name, the system loads only the specified overlay into memory. 


LOGIN [p,pn] 


Creates a new job by logging in to an account at a terminal, logs in your 
current job under a different account, or resets your current job to its 
initial logged-in state. You can also log in using a system logical name; 
the logical name specified must be a system logical that translates into 
a valid PPN. 

Privilege required: 


¢ DEVICE to log in to an account at a restricted terminal 
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LOGOUT 


¢ GACNT or WACNT to log in to a new job under a different account 
at a terminal, or, without specifying a password 
Command Qualifiers 


/INOJOVERRIDE[=NOLOGINS] 
Indicates whether the job should still be created if NO LOGINS is set. 
The default is /NOOVERRIDE. 


/TERMINAL=KB[ce]n[:] 
Specifies the keyboard to log in. 


Ends a terminal session. 


Privilege required: none 


Command Qualifiers 


/BRIEF 
Displays nothing when you log out. The default is /FULL. 


/FULL 
Displays complete information about your use of system resources when 
you log out. 


MACRO {/RSX11 |/RT11} filespecf,...] 


Invokes the MACRO-11 assembler for up to six MACRO-11 source files. 
Privilege required: 

¢ Read access to the files you are assembling 

¢ Create/rename access to any files you create 

Command Qualifiers 


ANOJLIST[=listfile] 
Indicates whether to create an output listing file. The default is /LIST. 


[INOJOBJECT{=objfile] 
Indicates whether to generate an output object file. The default is 
/OBJECT. 
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File Qualifier 


/LIBRARY 
Specifies that the file is a macro library. 


MERGE input-filespec[,...]output-filespec 


Invokes the PDP-11 MERGE Utility to combine one or more previously 
sorted input files into a single output file. All input files must have 
been sorted on the same SORT key(s). 


Privilege required: none 


Command Qualifiers 

/(INOJCHECK_SEQUENCE 

Indicates whether to examine the input files to make sure that they are 
in order. The default is /CHECK_SEQUENCE. 


/COLLATING_SEQUENCE={ASCII | EBCDIC | MULTINATIONAL} 
Specifies the collating sequence. The default is 
/COLLATING_SEQUENCE=ASCII. 


/[NOJDUPLICATES 
Indicates whether to allow duplicate records. The default is 
/DUPLICATES. 


/KEY=(field[,...]) 
Defines up to 10 MERGE keys. 


/SPECIFICATION|[=filespec] 
Specifies the file containing commands, file qualifiers, and key field 
definitions. 


/[NO|STABLE 
Indicates how input files containing records with equal keys are to be 
merged in the output file. The default is /NOSTABLE. 


/INOJSTATISTICS 
Indicates whether to display a statistical summary after the MERGE 
operation. The default is /NOSTATISTICS. 
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Input File Qualifiers 


/FORMAT=(record-formatf,...]) 
Specifies input record formats that override the existing data that 
MERGE normally obtains through PDP-11 RMS. 


/INDEXED_SEQUENTIAL[=n] 

Specifies that the input file organization is indexed-sequential and 
the number of keys; the valid range for n is 1 to 255. The default is 
/INDEXED_SEQUENTIAL=1. 


/INOJSHAREABLE 
Indicates whether to open the input files in write-shareable mode. The 
default is /NOSHAREABLE. 


/TREE_SPACE=n 

Specifies the percentage distribution of available work area between 
SORT/MERGE tree-related data structures and I/O-related data struc- 
tures; the valid range for n is 1 to 100 percent (%). The default division 
of work area is 30% to the merge list and 70% to I/O. 


Output File Qualifiers 


/ALLOCATION=n 
Specifies the number of 512-byte blocks allocated for the output file; the 
maximum value for n is 4294967295. 


/BUCKET_SIZE=n 
Used with disk files, specifies the number of 512-byte blocks per bucket 
for the output file; the maximum value for n is 32. 


/[[INOJCONTIGUOUS 
Indicates whether to allocate contiguous disk space for the output file. 
The default is /NOCONTIGUOUS. 


/FORMAT=(record-formatt,...]) 

Defines the output file record format. 
/INDEXED_SEQUENTIAL[=n] 

Specifies that the output file organization is indexed-sequential and 


the number of keys; the valid range for n is 1 to 255. The default is 
/INDEXED_SEQUENTIAL=1. 


/LOAD_FILL 
Used only with indexed files, loads the buckets according to the fill size 
established when the file was created. 
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/[NOJOVERLAY 
Indicates whether to overlay an existing file with the sorted records of 
the input file. The default is /NOOVERLAY. 


/RELATIVE 
Specifies that the output file organization is relative. 


/SEQUENTIAL 
Specifies that the output file organization is sequential. 


(For disks) MOUNT disk-device-name[:] pack-id [logical-name[:]] 


Prepares a disk drive for processing by system commands or user 
programs. 


Privilege required: MOUNT when mounting a disk drive mounted 
/SHAREABLE or /NOSHAREABLE by another user or mounted 
/NOREBUILD and the disk is dirty. 


Command Qualifiers 


/OVERRIDE[=IDENTIFICATION] 
When you specify /OVERRIDE, MOUNT ignores the pack ID. 


/PRIVATE 
Mounts the disk as private, allowing access only to those users having 
an account on the disk. 


/PUBLIC 
Mounts the disk as public, allowing access to all system users. The 
default is /PRIVATE. 


[INO]JQUOTA 
Indicates whether to perform quota checking when the disk is mounted. 
/[NOJREBUILD 


Indicates whether to rebuild a disk regardless of whether the disk was 
initialized for read/write or read-only. 


/[NOJRESTRICT 
Indicates whether to restrict the use of MOUNT to those users having 
MOUNT privilege. The default is /NORESTRICT. 
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/[NO]JSHAREABLE[=n] 

Indicates whether to allow access to all users having an account on 

a private disk instead of only the specified job. /SHAREABLE, the 
default, allows access to all jobs. /NOSHAREABLE[=n], where n 
specifies a job number, allows access to only that job; the default for n 
is your job. 

/INOJWRITE 

Indicates whether to write data to the disk. The default is /NOWRITE. 


(For tapes) MOUNT tape-device-name[:] [label] 


Prepares a tape drive for processing by system commands or user 
programs. 


Privilege required: DEVICE when mounting a restricted tape drive 


Command Qualifiers 


/DENSITY=n 

Specifies the density, in bits per inch, at which a magnetic tape will be 
read or written: n can be in the range 2 to 32766. Currently available 
densities are 800, 1600, 6250, 6667, 8000 and 10000 bpi. You can also 
specify MINIMUM or MAXIMUM, which causes the system to set the 
density to the minimum or maximum the tape drive supports. 


Any density you specify must match the density of the tape mounted. 


If you do not specify a density, MOUNT automatically determines the 
density of the tape mounted. 


/FORMAT={ANSI | DOS | FOREIGN} 
Specifies the tape label format. 


/OVERRIDE[=IDENTIFICATION] 

When you specify /OVERRIDE for ANSI format tapes, MOUNT ignores 
the tape label. DCL ignores /OVERRIDE on DOS format tapes. 
/[NOJWRITE 

Indicates whether to write data to the tape. 
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ON CONTROL_C THEN [$] command 


Specifies the action taken when a Ctrl/C interrupt occurs during 
execution of a command procedure. ON CONTROL_C has no effect at 
the interactive level. 


Privilege required: none 


ON severity-level THEN [$] command 


Specifies an action taken when DCL detects a warning, error, or severe 
error in a command procedure. ON has no effect at the interactive 
level. 


You can specify one of the following severity-level keywords: 


¢ WARNING 
¢ ERROR 
¢ SEVERE_ERROR 


Privilege required: none 


OPEN channel-number filespec 
Opens a disk file for reading or writing. The valid range for channel- 
number is 1 to 13. 
Privilege required: 
¢ Create/Rename access to create a new file 


¢ Read access to open an existing file for reading 
¢ Write access to replace or append to an existing file 


Command Qualifiers 


/APPEND 
Appends new records to the end of an existing disk file. 


/READ 
Opens a file for reading. The default is /READ. 
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/INOJREPLACE 
Indicates whether to replace an existing file if you also specify /WRITE. 


/WRITE 
Opens a file for writing. 


OPEN/LOG_FILE filespec 


Opens a disk file for terminal logging. 

Privilege required: 

e Create/Rename access to the log file you are creating 

¢ Write access to the file you are replacing or appending to 


Command Qualifiers 


/APPEND 
Adds data to the end of an existing log file or opens a new file if it does 
not exist. 


/DISABLE 
Disables terminal output logging to the log file. 


/ENABLE 
Enables terminal output logging to the log file. The default is 
/ENABLE. 


/[INOJREPLACE 
Indicates whether to replace an existing log file. 


/[NO]TIME_STAMP 
Indicates whether to prefix each line in the log file with a date/time 
stamp. The default is /NOTIME_STAMP. 


OPEN/QUEUE queue-name[:] 


Opens a queue for additional requests after it has been closed using the 
CLOSE/QUEUE command. 


Privilege required: PBSCTL 
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PRINT [node::]filespec[,...] [entry-spec] 


Queues one or more files for printing, either on a default system printer 
or on a device you specify. If you specify a node name, you cannot use 
any qualifiers or include an entry-spec. 

Privilege required: 

¢ Read access to the file(s) you are printing 

¢ Write access to use /DELETE 

¢ GACNT to specify another owner in your group 

¢ WACNT to specify another owner not in your group 


Command Qualifiers 


/AFTER=date-time 
Specifies an absolute or relative date-time value after which the entry 
is eligible for processing. 


/FORMS=form-name 
Specifies the name of the form you want to use for this request. 


/HOLD 
Places the entry in a "hold" state in the queue. 


/JOB_COUNT=n 
Specifies the number of job copies you want to print; the valid range for 
nis 1 to 255. The default is /JOB_COUNT=1. 


/NAME=entry-name 
Specifies a 1- to 9-character name for the entry. 


/[[NOJNOTIFY 
Indicates whether to notify your terminal session of events that occur 
related to your print entry. The default is /NONOTIFY. 


/OWNER=Ip,pn] 
Specifies the owner of the print request. 


/PAGE_LIMIT=n 
Specifies the maximum number of pages in the print job. The valid 
range for n is 1 to 4294967295 in addition to UNLIMITED. 
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/PRIORITY=n 

Specifies the priority you want to assign to the request; the valid range 
for n is 1 to 255. 

/QUEUE=queue-name[:] 

Names the queue you want to handle the request. 


File Qualifiers 


/[NOJCONVERT 
Indicates whether to convert all 0 ("zero") characters to O ("oh") charac- 
ters. The default is /NOCONVERT. 


/COPIES=n 


Specifies the number of file copies you want to print; the valid range for 
n is 1 to 255. The default is /COPIES=1. 


/[NOJDELETE 
Indicates whether to delete the file after printing. The default is 
/NODELETE. 


/[NOJFEED 

Indicates whether to execute a form-feed sequence at the bottom 
margin of each page. The default is /FEED. 

/[NO]JFLAG_PAGES 


Indicates whether to print flag (header) pages at the top of each file 
copy. The default is /FLAG_PAGES. 


AINOJTRUNCATE 
Indicates whether to truncate lines that exceed the form’s width. The 
default is /INOTRUNCATE. 


/[[NOJWRAP 

Indicates whether the characters that exceed the form width should 
print on the next line. /NOWRAP causes the characters to print on the 
same line. The default is /WRAP. 


READ channel-number symbol-name 


Reads the next record from a disk file that you have open for reading 
and assigns the contents of the record to the specified symbol name. 


Privilege required: none 
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Command Qualifiers 


/[NO]DELIMITER 
Indicates whether to include the record delimiter in the symbol name. 


/END_OF_FILE=label 

Specifies the label of the command file line to which you want to pass 
control when the system detects an end-of-file (EOF) condition during a 
read. 


/GLOBAL 
Searches the global symbol table for the specified symbol. The default 
is /LOCAL. 


/LOCAL 
Searches the current locai symboi tabie for the specified symbol name. 


RECALL {[integer] | leading-substring} 


Displays the command line specified by the integer or most recent 
command line that matches the substring. Leading-substring refers to 
the first several characters in a command string. 


Privilege required: none 


Command Qualifiers 


/ALL 
Displays all commands currently stored in the recall buffer along with 
their command numbers. 


/ERASE 
Erases the contents of the recall buffer. /ERASE is ignored if the /ALL 
qualifier is specified. 


REMOVE/ERROR_FILE 


Removes the system error file. 


Privilege required: INSTAL 
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Command Qualifiers 


/[NO]JLOG 
Indicates whether to display a confirmation message after removing the 
error file. The default is /LOG. 


REMOVE/JOB job-number 


Immediately terminates the specified job and logs it off the system. 
Privilege required: JOBCTL 


Command Qualifiers 


/[[INOJCONFIRM 
Indicates whether to prompt before terminating the specified job and is 
a synonym for /[NO]QUERY. The default is /CONFIRM. 


/[NOJQUERY 
Indicates whether to prompt before terminating the specified job and is 
a synonym for /[[NO]JCONFIRM. The default is /QUERY. 


REMOVE/LIBRARY library-name 


Removes the specified resident library from the list of installed resident 
libraries. 


Privilege required: INSTAL 


REMOVE/OVERLAY_FILE 
Removes the system overlay file. 
Privilege required: INSTAL 


Command Qualifiers 


/[NOJLOG 
Indicates whether to display a confirmation message after removing the 
overlay file. The default is /LOG. 
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REMOVE/RUNTIME_SYSTEM name 
Removes the specified run-time system from the list of installed run- 
time systems. 


Privilege required: INSTAL 


REMOVE/SWAP FILE [=]index 


Removes the specified system swap file. Index can be 0, 1, or 3. 
Privilege required: INSTAL 


Command Qualifiers 


/[NOJLOG 
Indicates whether to display a confirmation message after removing the 
swap file. The default is /LOG. 


RENAME old-filespecf,...] new-filespec 


Changes the file name or type of an existing file. 
Privilege required: 
¢ Create/rename access to the file you are renaming 


¢ Write access to the file you are replacing 


e SYSIO and Write access to set the privilege bit <128> in the 
protection code for non-executable files (files with the executable bit 
<64> not set). 


¢ TMPPRV and Write access to set the privilege bit <128> in the 
protection code for executable files (files with the executabie bit 
<64> set). 
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Command Qualifiers 


/BEFORE=date 

/CREATED 

/MODIFIED 

/SINCE=date 

Renames files you created or modified before or since the specified date. 


/INOJCONFIRM 
Indicates whether to prompt before renaming files and is a synonym for 
/[INOJQUERY. The default is /NOCONFIRM. 


/(INOJLOG 
Indicates whether to display a confirmation message on your terminal 
for each file renamed. The default is /LOG. 


/PROTECTION=n 
Specifies a protection code for the renamed file. 


/[INOJQUERY 
Indicates whether to prompt before renaming files and is a synonym for 
/(INO]JCONFIRM. The default is /NOQUERY. 


/[NOJREPLACE 
Indicates whether to replace existing files having the same file name. 
The default is /NOREPLACE. 


=SIZE=n 

=SIZE=MINIMUM=n 

=SIZE=MAXIMUM=n 
=SIZE=(MINIMUM=m,MAXIMUMEn) 
Selects files based on their size. The specified size can be: 


/SELECT 


n Selects only those files with size equal to n. 

MINIMUM=en Selects only those files with size greater 
than or equal to n. 

MAXIMUME=en Selects only those files with size less than 
or equal to n. 

MINIMUM=m,MAXIMUM=n Selects only those files with size between m 


and n inclusive. 


/[LNOJWARNINGS 

Indicates whether to display an error message if you try to re- 
name a file to the name of a file that already exists. The default is 
/WARNINGS. 
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REPLY [["]message-text["]] 


Responds to user and application requests and stores the reply in the 
Operator/Message Services (OMS) work file. Message-text specifies 
the text of the reply. Enclose strings containing lowercase letters or 
nonalphanumeric characters (including spaces) in quotation marks. 


Privilege required: OPER 


Command Qualifier 


/ABORT=identification-number 
Answers the request from a user or application corresponding to the 
identification number and aborts the request. 


/ANSWER-=identification-number 
Sends the reply text to the user or application corresponding to the 
identification number and successfully completes the request. 


/DISABLE 

Indicates that the terminal will not perform as an operator services 
console. REPLY/DISABLE is a synonym for 

SET TERMINAL/NOOPERATOR_SERVICES. 


{ENABLE 

Indicates that the terminal is enabled as an operator services console. 
REPLY/ENABLE is a synonym for SET TERMINAL/OPERATOR_ 
SERVICES=ALL. 


/PENDING=identification-number 

Answers the request from a user or application corresponding to the 
identification number but does not fulfill the request. The request 
remains pending until the operator aborts or answers the request. 


/PROMPT 

Prompts the user for multiple lines of text that make up the reply. 
The reply is entered similarly to the CREATE and BROADCAST 
commands. By using this qualifier, the length of the reply text can 
have a maximum of 500 characters. 


This qualifier conflicts with the message-text parameter, and will cause 
an error if both are specified on the same command line. 


/STATUS 
Displays the pending requests from work files. 
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/TO=identification-number 

Answers the request from a user or application corresponding to the 
identification number and successfully completes the request. This 
qualifier is a synonym for the /ANSWER qualifier and is provided for 
VMS compatibility. 


REQUEST ["Jrequest-text["] 


Broadcasts a message or request to all operators and operator terminals 
on the system. It stores the message or reply in the Operator/Message 
Services (OMS) work file. 


Privilege required: none 


Command Qualifiers 


/PROMPT 

Prompts for multiple lines of text that will make up the text of the 
request. The text is entered in a manner similar to the CREATE and 
BROADCAST commands. The length of the request text can have a 
maximum of 500 characters. This qualifier conflicts with the request- 
text parameter, and will cause an error if both are specified on the 
same command line. 


/[NOJREPLY 

Indicates whether a reply is expected. /REPLY indicates that a reply 
is required. The job will be placed in a wait state until an operator 
replies to or terminates your request, or until you type CTRL/C to 
terminate your request. /NOREPLY indicates that no reply is expected, 
and control returns to DCL after the REQUEST has been sent. The 
default is /REPLY. 


ANOJTIME_OUT[=wait-minutes] 

Specifies the length of time (in minutes) to wait for a reply. If no reply 
is given after the amount of time specified, the request will be aborted. 
You can specify any integer in the range 1 to 255. By default, there is 
no time limit imposed on the REQUEST command. 
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RESTORE input-backup-set-spec output-filespec[:] 


Lets you selectively restore accounts or files from a BACKUP media 
onto a specified disk. 


Privilege required: 

¢ Read access to the backup set file 

¢ Create access to restored filespecs 

¢ DATES to restore the file’s original creation and access dates 

e INSTAL to exceed system dynamic region limit 

e SYSIO to restore files to [0,1] 

e TUNE to use the /BUFFER SIZE qualifier and for better system 
performance 

¢ WACNT and GACNT to use the /ACCOUNT_DATA qualifier 


Command Qualifiers 


/[INOJACCOUNT_DATA 

Indicates whether to create accounts that meet the selection criteria. 
The default is /ACCOUNT_DATA. This qualifier has no effect unless 
you specified /ACCOUNT_DATA for the backup process. 


/[NOJASSIST 

Indicates how to send media mount requests to an operator. By 
specifying /ASSIST, you can send the media mount requests to an 
operator through the Operator/Message Services (OMS). The default, 
/NOASSIST, sends media mounts requests through your terminal. 


/BUFFER_SIZE=n 

Overrides the default dynamic region size. Larger values may improve 
performance at the expense of greater system impact. The valid range 
for nis 3 to 255 or MAXIMUM. You can also specify OPTIMUM or 55. 
The default is the minimum usable size, except when using an MS- or 
MU-class tape drive in which case the default is 55. 


/CREATED=date:time 
/CREATED=(AFTER=date:time, BEFORE=date:time) 
/MODIFIED=date:time 
/MODIFIED=(AFTER=date:time, BEFORE=date:time) 
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Restores files created or modified on, before, after, or between the 
specified date:times. The date:time argument can be any valid DCL 
date and/or time. 


/END={[NOJREWIND | [NOJDISMOUNT} 

Specifies whether to rewind the output tape drive or dismount the 
output disk following the successful completion of the backup operation. 
The default for disks is /END=DISMOUNT. The default for tapes is 
/END=NOREWIND. 


/EXCLUDE=(filespec-list) 
Specifies one or more files that should not be restored from the saveset. 


/[NOJFILE_DATA 

Indicates whether to transfer files from the saveset. Use this qualifier 
with the /ACCOUNT_DATA qualifier to create accounts only. The 
default is /FILE_DATA. 


/INCLUDE=(filespec-list) 
Specifies the files or accounts you want unconditionally processed. 


/AIN_LABEL=name 
Specifies the name you want compared to the source volume ID. 


/INOJINITIALIZE[=([NOJERASE,[NOJEXERCISE,EXERCISE=n, 
CLUSTER_SIZE=n, [NO]QUERY)] 

Indicates whether to initialize the output disk before creat- 

ing the backup file. The arguments allow you to have more 
control over the initializing of disks in the backup operation. 

For /INITIALIZE=EXERCISE=n, n can be 0, 1, 2, or 3. For 
/INITIALIZE=CLUSTER_SIZE=n, n can be 1, 2, 4, 8, 16, 32, or 64. 


If you specify /INITIALIZE, the output disk will be initialized based on 
the attributes (pack ID, pack cluster size, etc.) of the input disk. The 
default is /NOINITIALIZE. 


/[NOJLIST_FILE[=filespec] 
Indicates whether to create a directory-like listing file that catalogs the 


sequence of RESTORE events and is a synonym for /[NOJOUTPUT. The 
default is /LIST_FILE=KB: or your terminal. 


/OCCURRENCE=number 
Specifies the occurrence of the named backup set used in the RESTORE 
process. The default is the first occurrence. 
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/INOJOPTIMIZE 

/OPTIMIZE=CLUSTER_SIZE 

/OPTIMIZE=DIRECTORY 

Indicates whether to optimize file cluster sizes, file directories, or 
both on the output disk. The default, /OPTIMIZE, performs both 
optimizations. 


/OUT_LABEL=name 

Specifies the name used for the pack ID of the output disk and provides 
a means to ensure that you are referencing the correct output disk. If 
the /INITIALIZE qualifier is not specified and the pack ID does not 
match the one found on the specified output disk, then BACKUP dis- 
plays an error and rejects the command. If the /INITIALIZE qualifier 
is specified, then the output disk label will be set to the name specified 
with /OUT_LABEL. 


/[NOJOUTPUT{[=filespec] 

Creates a directory-like listing file that catalogs the sequence of 
RESTORE events and is a synonym for /[NOJLIST_FILE. The default 
is /OUTPUT=KB: or your terminal. 


/PLACED_POSITION=position 
Specifies where RESTORE attempts to place files marked as placed at 
a specific location; position can be: 


INDEX Places the files near the storage allocation table. 
MIDDLE Places the files near the middle of the disk. 
ORIGINAL Places the files at the position on the source file. 
The default is /PLACED_POSITION=INDEX. 
/INOJPROMPT 


Indicates whether to prompt for the first volume name. The default is 
/PROMPT. 


/JINOJIQUERY 

Indicates whether to prompt before restoring each file selected. 
Specifying /QUERY displays the name of each file selected and asks 

if you want to restore that file. Answer Y or YES to restore the file 
displayed, or N or NO to skip the file and continue with the next file. 
The default, /NOQUERY, restores each file selected without prompting. 
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You can also specify /ALL with the YES or NO reply to indicate that 
the reply applies to all remaining file transfers. This eliminates fur- 
ther queries. YES/ALL causes all remaining files to be restored and 
NO/ALL causes all remaining files to be skipped. 


/INOJREPLACE[=QUERY] 

Indicates whether to replace an existing file on the destination device 
when a file being transferred has the same name. /REPLACE indi- 
cates that new files should replace existing files of the same name. 
/NOREPLACE indicates that existing files should not be replaced. 


The default, /REPLACE=QUERY, indicates that RESTORE should 
prompt you before replace each existing file. Answer Y or YES to 
replace the current file. Answer N or NO to not replace the existing file 
and proceed with the next file. 


You can also specify /ALL with the YES or NO reply to indicate that 
the reply applies to all remaining file replacements. This eliminates 
further queries. YES/ALL causes all remaining files to be replaced and 
NO/ALL causes all remaining files to be skipped. 


ANOJREWIND 
Indicates whether to rewind a magnetic tape saveset volume before 
processing. The default is /NOREWIND. 


/SELECT=(filespec-list) 
Specifies the files you want to restore. The default is all files in the 
backup set. 


/INOJVERIFY[=ONLY] 

Indicates whether to perform a comparison operation of all data trans- 
ferred to the output disk. If you specify /VERIFY, then RESTORE 
performs a second pass through the input disk, comparing each account 
and file transferred with that on the output disk. RESTORE reports 
any differences found. 


You can use RESTORE/VERIFY=ONLY to perform a verify operation 
without transferring any data. The default is /NOVERIFY. 
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RESTORE/DIRECTORY backup-set-spec 


Lists files within a backup saveset. 
Privilege required: 


¢ Read access to the backup set file 
¢ TUNE to use the /BUFFER_SIZE qualifier 
e INSTAL to exceed system dynamic region limit 


Command Qualifiers 
/[NOJASSIST 


Indicates how te send media mount requests to an operator. By specify- 
ing /ASSIST, you can send the disk or tape media mount requests to an 
operator through the Operator/Message Services (OMS). The default, 
/NOASSIST, sends media mounts requests through your terminal. 


/BRIEF 
Displays a format similar to the DCL full directory (minus file at- 
tributes) and is the default qualifier. The default is /BRIEF. 


/BUFFER_SIZE=n 

Specifies the size in k-words of the RESTORE buffer in memory. 
Larger values may improve performance at the expense of greater 
system impact. The valid range for n is 3 to 255 or MAXIMUM. You 
can also specify OPTIMUM or 55. The default is the minimum usable 
size, except when using an MS- or MU-class tape drive in which case 
the default is 55. 


/CREATED=date 

/CREATED=(BEFORE=date:time, AFTER=date:time) 
/MODIFIED=date 

/MODIFIED=(BEFORE=date:time, AFTER=date:time) 

Lists files created or modified on, before, after, or between the specified 
date:times. The date:time argument can be any valid DCL date and/or 
time. 


/END={[NOJREWIND | [NOJDISMOUNT} 

Specifies whether to rewind the output tape drive or dismount the 
output disk following the successful completion of the RESTORE 
operation. The default for disks is /END=DISMOUNT. The default for 
tapes is /END=NOREWIND. 
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/EXCLUDE=(filespec-list) 
Specifies one or more files that should not be listed. 


/FULL 
Displays detailed information for each file on multiple lines. 


To display information for specific files use (SELECT or /EXCLUDE 
with RESTORE/DIRECTORY. 


/AINCLUDE=(filespec-list) 
Specifies the files or accounts you want transferred to the saveset. 


/IN_LABEL=name 
Specifies the name you want compared to the source volume ID. 


/([NOJLIST_FILE[=filespec] 

Indicates whether to create a log file that catalogs the sequence of 
RESTORE events. The log contains information about the accounts 
and files transferred, and the disk volumes used. The default is /LIST_ 
FILE=KB: or your terminal. 


/OCCURRENCE=number 
Specifies the occurrence of the named backup set used in the RESTORE 
process. The default is the first occurrence. 


/[NOJOUTPUT{=filespec] 

Creates a directory-like listing file that catalogs the sequence of 
RESTORE events and is a synonym for /[NO]JLIST_FILE. The default 
is /OUTPUT=KB: or your terminal. 


/INOJPROMPT 

Indicates whether to prompt for the first volume name. The default is 
/PROMPT. 

/LNOJREWIND 


Indicates whether to rewind a magnetic tape saveset volume before 
processing. The default is /NOREWIND. 


/SELECT=(filespec-list) 
Specifies the files you want to list. The default is all files in the backup 
set. 
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RETURN [status-code] 


Returns control to the command following the calling GOSUB com- 
mand. If you specify a status-code, DCL uses this value to set the 
$STATUS and $SEVERITY symbols that determine the exit status for 
this command. Status-code can be an expression. 


Privilege required: none 


RUN filespec 


Executes a program or a command file. 


Privilege required: Execute access to the program 


SET ACCOUNT dev:[p,pn] 


Modifies one or more account attributes. 


Privilege required: GACNT or WACNT 


Command Qualifiers 


[LINOJCAPTIVE 
Indicates whether the account is to be a captive account. 


/DETACHED_JOB_QUOTA=detached-job-quota 

Specifies the maximum number of jobs that can exist in a detached 
state for an account at one time. The valid range for detached-job-quota 
is 0 to 63 or UNLIMITED. 


/[NOJDIALUP 
Indicates whether to allow logins via a dialup facility. 


/[NOJEXPIRE[=date] 

Specifies the account expiration date. The account is marked as expired 
when you specify /EXPIRE. The account never expires when you specify 
/NOEXPIRE. 


/IN_QUOTA=logged-in-quota 

Specifies the number of disk blocks the system allows you to allocate 
while logged in. The valid range for logged-in-quota is 0 to 16777214 or 
UNLIMITED. 
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/[INOJINTERACTIVE 
Indicates whether to allow interactive access to the account. Batch jobs 
can still run under the account. The default is INTERACTIVE. 


/JOB_QUOTA=job-quota 

Specifies the maximum number of LOCAL, DIALUP, or NETWORK job 
types that can exist at one time for this account. The valid range for 
job-quota is 0 to 63 or UNLIMITED. 

/[NOJLOG 

Determines what type of information SET ACCOUNT writes to a log 
file. By default, SET ACCOUNT logs all modifications of an account. 
When you specify /NOLOG, SET ACCOUNT logs warning messages 
only. The default is /LOG. 


/[NOJLOOKUP 
Indicates whether to allow passwords to be looked up. 


/MESSAGE_QUOTA=message-quota 

Specifies the number of outstanding messages that a job running under 
this account can request when declaring itself to be a receiver. The 
valid range for message-quota is 0 to 65534 or UNLIMITED. 


/NAME="account-name" 
Specifies the account name. You can specify up to 13 characters. 


/INOJNETWORK 
Indicates whether to allow any network connections into this account. 


/OUT_QUOTA=logged-out-quota 

Specifies the number of disk blocks the system allows a user to re- 
tain when logging out, or creating or extending a file in a logged-out 
account. The valid range for logged-out-quota is 0 to 16777214 or 
UNLIMITED. 


/[INOJPASSWORD_PROMPT 
Indicates whether to require a password when a user logs in. 


/PRIVILEGES=(priv{....]) 
Modifies the privileges currently assigned to an account. Priv can be: 


ALL All privileges granted. 
NONE All privileges denied. 
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Privilege keyword Specified privilege granted. 
Privilege keyword with "NO" _— Specified privilege denied. 
prefix 


Modifications to privileges do not take affect until the next time you 
log in to the account. See Table 1-7 for a list of RSTS/E privilege 
keywords. 

/RIB_QUOTAs=rib-quota 

Specifies the number of receiver ID blocks (RIBs) that a job running 


under this account can set up for itself as a message receiver. The valid 
range for n is from 0 te 256 or UNLIMITED. 


/INOJUSER 


Specifies the type of account. /USER specifies an account with login 


AVVLAVUYUD C444 LAA DOUYUL ge Capaciiuss. fAUVUVEILY species an aALYLUUULL 


with file storage capabilities only. The default is all accounts. 


SET CACHE 


Enables directory and data caching. 
Privilege required: TUNE 


Command Qualifiers 


/ALL 
Caches all data transfers. 


/CLUSTERSIZE=n 
Specifies the cache cluster size. The valid values for n are 1, 2, 4, or 8. 
The default is 4. 


/DATA_MAXTMUM=n 

Specifies the maximum number of cache clusters you want to use 
for data caching. The valid range for n is 0 to 65535 in addition to 
UNLIMITED. 


/DIRECTORY_MAXIMUME=n 

Specifies the maximum number of cache clusters you want to use for 
directory caching. The valid range for n is 0 to 65535 in addition to 
UNLIMITED. 
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/DISABLE 
Disables data and directory caching. The default is /ENABLE. 


/ENABLE 
Enables data and directory caching, using previous settings as defaults. 


/[NO]JFILE 
Indicates whether to allow file data caching. The default is /FILE. 


/KEEP=n 

Specifies the cache replacement time, in seconds, an unused cache 
cluster remains in memory before being used for another cache cluster. 
The valid range for n is 0 to 65535. 


/MAXIMUM=n 
Specifies the maximum number of data and directory cache clusters. 
The valid range for n is 0 to 65535 in addition to UNLIMITED. 


SET CONTROL=C 


Re-enables Ctri/C checking within a command procedure. See also SET 
NOCONTROL=C. 


Privilege required: none 


SET DATA 


Allows you to supply data to a program from within a command 
procedure. See also SET NODATA. 


Privilege required: none 


Command Qualifier 


/END_OF_DATA="char" 
Specifies an alternate prefix character to signal the end of data. The 
default is /END_OF_DATA="$". 
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SET DATE date[:time] 


Sets the system date. You can specify any valid DCL relative or 
absolute date/time string. For additional information on entering dates 
and times, see the section, "Rules for Entering DCL Commands." 


Privilege required: DATES 


SET DEVICE dev{[:] 


SET ECHO 


Sets the characteristics of a device. 

Privilege required: 

¢ HWCTL and HWCFG to use the /DISABLE qualifier 
¢ HWCEFG to use ‘RESTRICT 

¢ HWCTL to use /ENABLE 

¢ HWCFG and DEVICE to use /NORESTRICT 


Command Qualifiers 


/DISABLE 
Disables the specified device. 


/ENABLE 
Enables the specified device that you previously disabled. 


/[NOJRESTRICT 
Indicates whether to restrict allocating and opening the specified device 
only to users having DEVICE privilege. 


Re-enables terminal output during execution of a command procedure. 
See also SET NOECHO. 


Privilege required: none 
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SET ENTRY {entry-spec | entry-number} 


Modifies one or more entry attributes for an entry or entries on a 
queue. You can also use SET ENTRY to hold or release an entry. 


Privilege required: 


¢ None to change entries you own 
¢ PBSCTL to use the /PRIORITY, HOLD, and /RELEASE qualifiers 
for any entry you do not own 


¢ WACNT to use the /AFTER, /CPU_LIMIT, /FORMS, /HOLD, 
/JOB_COUNT, /PAGE_LIMIT, /PRIORITY, /RELEASE, and 
/TIME_LIMIT qualifiers for an entry not in your group 


¢ GACNT to use the /AFTER, /CPU_LIMIT, /FORMS, /HOLD, 
/JOB_COUNT, /PAGE_LIMIT, /PRIORITY, /RELEASE, and 
/TIME_LIMIT qualifiers for an entry in your group 


Command Qualifiers 
ALINOJAFTER=date:time 


Indicates an absolute or relative date:time value after which 
Print/Batch Services (PBS) processes the entry. 


/BATCH 
Selects only batch queue entries for modification. 


/CPU_LIMIT=n 

Specifies the maximum CPU time, in minutes, allowed for the batch 
job. The valid range for n is 1 to 65535 in addition to UNLIMITED. 
You cannot specify a value for n that exceeds the maximum CPU limit 
assigned to the queue. 


/FORMS=form-name 
Specifies the name of the form you want to use for this entry. 


/HOLD 
Places the entry in a hold state. To process the entry, you must release 
it by using the SET ENTRY/RELEASE command. 


/JOB_COUNT=n 
Specifies the number of job copies you want printed. The valid range 
for n is 1 to 255. 
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/PAGE_LIMIT=n 

Specifies the maximum number of pages in the print job. The valid 
range for n is 1 to 4294967295 in addition to UNLIMITED. You cannot 
specify a value for n that exceeds the maximum page limit assigned to 
the queue. 


/PRINT 
Selects only print queue entries for modification. 


/PRIORITY=n 

Specifies the priority you want to assign to the request. The valid 
range for n is 1 to 255. You cannot specify a value for n that is higher 
than the maximum priority assigned to the queue. 

/RELEASE 


Releases the entry from its hold s 


can process it. 


/TIME_LIMIT=n 

Specifies the maximum elapsed time, in minutes, you want to allow for 
the requested batch job. The valid range for n is 1 to 65535 in addition 
to UNLIMITED. You cannot specify a value for n that exceeds the 
maximum time limit assigned to the associated queue. 


SET FILE filespec 


Sets the characteristics of a file. 
Privilege required: 
¢ Create/rename to use the /PROTECTION qualifier 


e Write access to use the /NOCONTIGUOUS, [ANOJPLACED, and 
/RUNTIME_SYSTEM qualifiers 


e SYSIO and Write access to use the [NO]DELETABLE qualifier 
and to set the privilege bit <128> in the protection code for non- 
executable files (files with the executable bit <64> not set). 


¢ ‘TMPPRV and Write access to set the privilege bit <128> in the 
protection code for executable files (files with the executable bit 
<64> set). 


e TUNE and Write access to use the /[NO]JCACHE qualifier 
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Command Qualifiers 


/[NOJBACKUP 

Indicates whether to backup the contents of the file during a backup 
operation. When you specify /NOBACKUP, the file’s attributes are 
included in the backup operation but the file’s contents are not. The 
default is /BACKUP. 


/[NO]JCACHE[=RANDOM | SEQUENTIAL] 
Indicates whether to cache data in an open file. The default is 
/CACHE=RANDOM if you specify /CACHE with no argument. 


/NOCONTIGUOUS 
Marks a contiguous file as noncontiguous, allowing extension of the file. 


/[NOJDELETABLE 
Indicates whether to mark a file for deletion and renaming. 


/[NOJIGNORE 
Indicates whether to ignore the file for all backup operations. The 
default is /NOIGNORE. 


[[NOJLOG 
Indicates whether to log the file specification of each modified file to 
your terminal. The default is /NOLOG. 


/[INOJPLACED 
Indicates whether to mark a file as being placed in its present position. 


/PROTECTION=n 
Specifies the protection code you want to assign to a file; the valid 
range for n is 0 to 255. 


/RUNTIME_SYSTEM=name 
Names the run-time system. 


SET HOST [=] [ _ Jnode[::][ _node::][...] 


Allows you to log in to another computer from the system you first 
logged in to. 


Privilege required: none 
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SET JOB [job-number] 


Defines the characteristics of the current or specified job. 


Privilege required: TUNE to use all qualifiers except 
/KEYBOARD_MONITOR and /PRIVILEGES 


Command Qualifiers 


/HOLD 
Sets the job priority to -128, preventing further execution. 


/KEYBOARD_MONITOR[=name] 
Changes your keyboard monitor. 


/PRIORITY[=n] 
Specifies the priority for a job. The valid range for n is -128 to 120, in 
multiples of 8. If you do not specify n, the default is -8. 


/PRIVILEGES=(priv[,...]) 
Modifies the set of your current job privileges. Priv can be: 


ALL All privileges granted. 

NONE All privileges denied. 

Privilege keyword Specified privilege granted. 

Privilege keyword with "NO" _— Specified privilege denied. 

prefix 

See Table 1-7 for a list of RSTS/E privilege keywords. 

/RELEASE 

Sets the job priority to the default priority, allowing the job to continue 
execution. 


/RUN_BURST[=n] 
Specifies the job run burst. The valid range for n is 1 to 127. If you do 
not specify n, the default is 6. 


/SIZE=n 
Specifies the maximum job size. The valid range for n is 1 to 255. 
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SET LOG _FILE 


Selectively enables or disables output to a log file that you previously 
opened using the OPEN/LOG_FILE command. 


Privilege required: none 
Command Qualifiers 


/DISABLE 
Disables logging of terminal and command file output. 


/ENABLE 
Enables logging of terminal and command file output to the log file. 


/((NOJTIME_STAMP 
Indicates whether to prefix each line in the log file with a date/time 
stamp. 


SET NOCONTROL=C 


Disables Ctrl/C checking within a command procedure. See also SET 
CONTROL=C. 


Privilege required: none 


SET NODATA 


Tells DCL to read all data required by a program or a command from 
the user’s terminal, instead of a command file. See also SET DATA. 


Privilege required: none 


SET NODE/LAT 


Initially sets or changes the LAT host node characteristics. 
Privilege required: SWCFG 
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Command Qualifiers 


/ACCESS={LOCAL | DIALUP} © 

Specifies whether connections on the terminal server should be treated 
as LOCAL or DIALUP. This qualifier only determines the access type 
for terminal servers that do not supply an access type. If a terminal 
server includes an access type, RSTS/E will ignore any /ACCESS 
setting and use the server’s access type instead. 


CAUTION 


Setting the access type to LOCAL for a terminal server that 
provides access to the system through dialup lines could 
compromise security. 


/DISABLE=({(group-codef[,...]) | ALL} 

Removes the specified group codes from the list of group codes asso- 
ciated with the LAT host node. The group list can include multiple 
codes separated by commas. For example, /DISABLE=(0,1,4,10) dis- 
ables group codes 0, 1, 4, and 10. The keyword ALL can be specified 
to indicate codes 0-255. The /DISABLE qualifier may be specified only 
once on a command line. No error is returned if a specified group code 
is not enabled. 


/ENABLE=({(group-codef[,...]) | ALL} 

Adds the specified group codes to the list of group codes associated with 
the LAT host node. The group list can include multiple codes separated 
by commas. For example, /ENABLE=(5,6,8,10) enables group codes 5, 
6, 8, and 10. The keyword ALL can be specified to indicate codes 0-255. 
The /ENABLE qualifier may be specified only once on a command line. 
No error is returned if a specified group code is already enabled. 


/IDENTIFICATION="node-id" 

Specifies a description for the LAT host node. This description can be 
used as an announcement string or to further identify the node. It may 
be up to 64 characters in length. 


/[NOJLOG 
Indicates whether to display a confirmation message for the requested 
action. The default is /NOLOG. 
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/MULTICAST_TIMER=seconds 

Specifies the interval, in seconds, between the multicast messages 
sent for service announcements. The minimum value is 10 seconds, 
the maximum value is 255 seconds. The default when the first SET 
NODE/LAT command is issued is 60 seconds. The following is an 
example of this command: 


$ SET NODE RSTS /MULTICAST_TIMER=50 


SET NOECHO 


Disables terminal output during execution of a command procedure. 
See also SET ECHO. 


Privilege required: none 


Command Qualifier 


/[NOJWARNINGS 
Indicates whether to display warning and error messages on your 
terminal. The default is (WARNINGS. 


SET NOON 


Overrides default error checking within a command procedure. See 
also SET ON. 


Privilege required: none 


SET NOVERIFY 


Informs DCL not to display lines in a command procedure as it executes 
them. See also SET VERIFY. 


Privilege required: none 
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SET ON 


Controls whether DCL performs error checking following the execution 
of commands in a command procedure. See also SET NOON. 


Privilege required: none 


SET OPERATOR_SERVICES 


Modifies the type of requests stored in the operator services work file. 


Privilege required: OPER 


Command Qualifier 


/[NOJKEEP=(keyword|[,...]) 

Specifies the type of requests that will be kept in the operator services 
work file. Valid keywords are ALL, [NOJMESSAGES, [NOJREQUESTS, 
and NONE. The /NOKEEP qualifier is a synonym for /KEEHP=NONE. 


SET PASSWORD [dev:[p,pn]J] 


Specifies the password for an account. Passwords for lookup accounts 

must be 6 characters long; passwords for NOLOOKUP accounts can be 

6 to 13 characters long. 

Privilege required: 

¢ GACNT or WACNT to specify a password for other accounts, or for 
the system password 

¢ SETPAS to specify a password for your own account 


Command Qualifiers 
/[NO]JLOG 


Indicates whether to display a message on your terminal confirming 
the password change. The default is /LOG. 


/SYSTEM 
The specified password replaces the current system password. 


DCL Commands 2-105 


SET PORT port-name[:] 


Changes the current characteristics of a local LAT port that was 
created by the CREATE/PORT command on a RSTS/E node. Note 
that the server name cannot be changed by the SET PORT command; 
to assign the local LAT port to a different terminal server, use the 
ASSIGN/PORT command. 


The port-name parameter specifies the name of the local port. The 
port-name must be in the form of KBIn: or KBn:, where n is a value 
from 0 through 127. 


Privilege required: SWCFG 


Command Qualifiers 


/LAT 
Sets the characteristics of a LAT port. The default is /LAT. 


/INOJLOG 
Indicates whether to display a confirmation message after the port is 
set. The default is /LOG. 


/[NOJQUEUED 

Indicates whether the connection to a terminal server will be placed on 
the server’s queue if the server supports queuing and the remote port 
is currently busy. If /NOQUEUED is specified and the remote port is 
busy, the connection will not be queued and it will fail. 


Use the SHOW PORT command to display the port’s connection status. 
If the port is set (QUEUED and the remote port is busy, a connection 
status of "In Progress" and the position in the queue will be shown. 


/[LNOJREMOTE_PORT|=remote-port-name] 

Specifies the name of a remote port on the terminal server to which the 
local port is to be connected. The remote port name can be up to 16 
alphanumeric characters in length. 


If /NOREMOTE_PORT is specified, the local port is deassigned from 
the current remote port. If you use this qualifier, you must select a 
service using the /SERVICE qualifier. 
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/[NOJSERVICE|[=service-name] 

Specifies the name of a remote service offered at the terminal server to 
which the iocai LAT port is to be connected. The service name can be 
up to 16 alphanumeric characters in length. 


If /NOSERVICE is specified, the local port is deassigned from the 
current remote service. If you use this qualifier, you must select a 
remote port using the /REMOTE_PORT qualifier. 


SET PRINTER dev[:] 
Changes the characteristics of the specified line printer. 
Privilege required: HWCFG 


Command Qualifiers 


/BACKSPACE[=mode] 
Determines how the system handles backspace characters. Possible 


modes are: 

CONTROL Handied like other nonprinting characters 

REAL System sends backspaces 

SIMULATE System sends a Carriage Return and the required 


number of spaces 
The default is /BACKSPACE=REAL. 


/INO]JCONTROLS 

Determines what the system sends the printer when processing 
nonprinting characters. When you specify ‘CONTROLS, the sys- 
tem sends untranslated characters to the printer. When you specify 
/NOCONTROLS, the system discards nonprinting characters or uses 
the up arrow (“) mode. 


/[NO]CR_PREFIX 
Indicates whether to insert a Carriage Return before LF, VT, and FF 
characters. 


/DEVICE_TYPE=type 
Specifies the characteristics of the line printer. Valid types are LNO1, 
LP11, and LA180. 
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/(NOJEIGHT_BIT 
Indicates whether to send 8-bit characters to the printer. 


/[NOJEOT 

Determines how the system handles the end-of-transmission (EOT) 
character (4D). When you specify /EOT, the system sends the EOT 
character to the printer without translation. When you specify 
/NOEOT, the system handles EOT as a nonprinting character. 


(INOJFILL 
Indicates whether to insert fill characters after FF characters. 


/LOWERCASE 
Sends untranslated lowercase characters to the printer. 


/[INOJOMIT_CR 
Indicates whether to send a Carriage Return to the printer if the next 
character is a LF character. 


/PAGE_LENGTH=n 
Specifies the printer default page length; the valid range for n is 1 to 
255. 


/[NO]JSPECIAL_CHARACTER[=char] 

Determines whether the printer prints its special character. When 
you specify char, the printer substitutes its special character for each 
occurrence. You can specify char by using its binary value (0 to 255) 
or by enclosing char in quotation marks, providing char is a printable 
character. 


/[NO]TAB 
Indicates whether to send tab characters to the printer instead of 
spaces. 


/UPPERCASE 
Converts lowercase characters to uppercase characters before sending 
them to the printer. 


/WIDTH=n 
Specifies the width of the printer; the valid range for n is 1 to 254. 
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SET PROMPT [prompt] 


Allows you to change your prompt text. The prompt can be an ex- 
pression or a quoted string. The maximum length allowed is 255 
characters. 


Privilege required: none 


Command Qualifier 


/LOG_FILE 
Enables the specified prompt only while logging your terminal session. 


SET PROTECTION[=]n filespec[,...] 


Specifies the protection code of a file. 
Privilege required: 


¢ Create/Rename access to the file you specify 

e SYSIO and Write access to set the privilege bit <128> in the 
protection code for non-executable files (files with the executable bit 
<64> not set). 

¢ 'TMPPRV and Write access to set the privilege bit <128> in the 
protection code for executable files (files with the executable bit 
<64> set). 


Command Qualifiers 


/BEFORE=date 

/CREATED 

/MODIFIED 

/SINCE=date 

Sets the protection of files created or modified before or since the 
specified date. 


/LNOJCONFIRM 
Indicates whether to prompt you before changing a file protection code 
and is a synonym for /[NOJQUERY. The default is /NOCONFIRM. 


/DEFAULT 
Specifies the protection code to assign to every file you create until you 
log out. Do not include a file specification when you use this qualifier. 
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/[INOJLOG 
Indicates whether to display a confirming message for each file whose 
protection code you change. The default is /LOG. 


/[INO]QUERY 
Indicates whether to prompt you before changing a file protection code. 
The default is /NOQUERY. 


=SIZE=n 

=SIZE=MINIMUM=n 

=SIZE=MAXIMUM=n 
=SIZE=(MINIMUM=m,MAXIMUM=n) 
Selects files based on their size. The specified size can be: 


/SELECT 


n Selects only those files with size equal to n. 

MINIMUM=n Selects only those files with size greater 
than or equal to n. 

MAXIMUM=n Selects only those files with size less than 


or equal to n. 
MINIMUM=m,MAXIMUM=n Selects only those files with size between m 


and n inclusive. 


SET QUEUE queue-name[:] 


Modifies one or more queue characteristics. When you change a queue 
characteristic, the change does not affect entries already in the queue; 
however, the change affects all later entries. 


Privilege required: PBSCTL 


Command Qualifiers 


/ALL 
Modifies all queues. 


/BATCH 
Modifies only batch queues. 


/CPU_LIMIT=(MAXIMUM<e=a,DEFAULT=b) 

/CPU_LIMIT=n 

Specifies the maximum and/or default CPU time limits (in minutes) you 
can specify when submitting a job to the queue. If you use the /CPU_ 
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LIMIT=n form, n specifies both the maximum and default limits. The 
valid range for a, b, and n is 1 to 65535 in addition to UNLIMITED. 


/[NOJDEFAULT 
Indicates whether to establish the specified queue as the default queue. 


/FORMS=form-name 
Specifies the name of the default forms for the print queue. 


/PAGE_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/PAGE_LIMIT=n 

Specifies the maximum and/or default page limits a user can specify 
when submitting a job to the queue. If you use the /PAGE_LIMIT=n 
form, n specifies both the maximum and default limits. The valid range 
for a, b, and nis 1 to 4294967295 in addition to UNLIMITED. 

/PRINT 

Modifies only print queues. 

/PRIORITY=(MAXIMUM=a,DEFAULT=b) 

/PRIORITY=n 

Specifies the maximum and/or default priorities a user can specify 
when submitting a job to the queue. if you use the /PRIORITY=n form, 


n specifies both the maximum and default limits. The valid range for a, 
b, and n is 1 to 255. 


/PRIVILEGES=(priv{,...]) 
Specifies the set of privileges a user must have to enter jobs in queue. 
Priv can be: 


ALL All privileges granted 
NONE All privileges denied 
Privilege keyword Specified privilege granted 


Privilege keyword with "NO" Specified privilege denied 
prefix 


See Table 1-7 for a list of RSTS/E privilege keywords. 


/TIME_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/TIME_LIMIT=n 

Specifies the maximum and/or default elapsed time limits (in minutes) 
you can specify when submitting a job to the queue. If you use the 
/TIME_LIMIT=n form, n specifies both the maximum and default 
limits. The valid range for a, b, and n is 1 to 65535 in addition to 
UNLIMITED. 
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SET SERVER sServer-name[:] 


Changes one or more characteristics for print and/or batch servers. For 
example, changing forms for print servers. 


Privilege required: 
e PBSCTL 
e¢ TUNE to specify the /PRIORITY or /RUN_BURST qualifiers 


Command Qualifiers 


/ALL 
Modifies all servers. 


/BATCH 
Modifies only batch servers. 


/[NOJCONTROLS[=UP_ARROW] 

Indicates how print servers handle control characters and escape 
sequences. If you do not specify this qualifier, then the current 
CONTROLS setting is not changed. 


/FORMS=form-name 

Specifies the name of the forms Print/Batch Services (PBS) installs for 
the specified print server. If you do not specify this qualifier, then the 
server’s current form is not changed. 


/PRINT 
Modifies only print servers. 


/PRIORITY[=n] 

Indicates the priority at which PBS runs command procedures con- 
trolled by the specified batch server. The valid range for n is -120 to 
120. PBS rounds n to the nearest multiple of 8. If n is not specified, 
the default is -8. If you do not specify this qualifier, then the batch 
server’s priority is not changed. 

/RUN_BURSTI[=n] 

Indicates the run burst PBS assigns to any command procedures 
controlled by this batch server. The valid range for n is 1 to 127. If nis 


not specified, the default is 6. If you do not specify this qualifier, then 
the batch server’s run burst is not changed. 
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/[NOJSHAREABLE 

Indicates whether to allow other jobs to share the printer. If you do not 
specify this qualifier, then the [NOJISHAREABLE characteristic is not 
changed. 


SET SERVICE/LAT service-name 


Modifies the information associated with a particular service being 
offered by the node. 


Privilege required: SWCFG 


Command Qualifiers 


/AIDENTIFICATION="service-id" 

Modifies the description for the service. This description is used to 
further identify the service being offered. It may be up to 64 characters 
in length. 

/[NOJLOG 

Indicates whether to display a confirmation message for the requested 
action. The default is /LOG. 


/STATIC_RATINGe=rating 

Specifies the static rating associated with the service. This rating 
directs terminal server users away from or toward a particular node. 
The range of values is 0 to 255. A value of 255 is highly available to 
users while a value of 0 is not available to users. The default static 
rating is 255. 


SET SYSTEM 


Sets the system default characteristics. 
Privilege required: 


¢ SWCEFG to use the /DATE_FORMAT, /DYNAMIC_REGION_LIMIT, 
/[NOJFMS, /HANGUP, /LABEL, /[NOJLAT, /NAME, /POWERFAIL_ 
DELAY, /PSEUDO_KEYBOARD, and /TIME_FORMAT qualifiers 


¢ HWCTL to use the /HOLD and /RELEASE qualifiers 
¢ HWCEFG to use the /DENSITY qualifier 
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¢ SWCTL to use the /ANSWERBACK, /EMT_LOGGING, /[NO]JLOGINS, 
and /[NOJSTATISTICS qualifiers 

e SYSIO to use the /MONITOR_NAME qualifier 

¢ TUNE to use the /SWAP_MAXIMUM qualifier 

¢ WACNT to use the [NOJPASSWORD_PROMPT qualifier 


Command Qualifiers 


/INOJANSWERBACK="text” 
Indicates whether to define a systemwide response for electronic 
messaging systems. 


/DATE_FORMAT={ALPHABETIC | NUMERIC} 
Specifies the system date format. The alphabetic format is dd-mmm-yy. 
The numeric format is yy.mm.dd. 


/DENSITY=default 

Specifies the magnetic tape default density; default can be in the range 
2 to 32766. Currently available densities are 800, 1600, 6250, 6667, 
8000, and 10000 bpi. You can also specify MINIMUM, or MAXIMUM. 


The default density you specify applies to all tape drives on the system. 


If you specify a default density that the tape drive does not support, 
the system selects the next higher density the tape drive supports. 


If you specify a default density that is higher than the highest density 
the tape drive supports, the system selects the tape drive’s maximum 
density. 


If you do not specify a system default density, the default is 1600 bpi. 


/DYNAMIC_REGION_LIMIT=n 

Sets the limit for the total size of all dynamic regions and FORTRAN 
virtual arrays that users can create without the INSTAL privilege. Any 
user having the INSTAL privilege can override this systemwide limit. 
This limit is also used by BACKUP when user does not have INSTAL 
privilege. 


/EMT_LOGGING=(emftf,...]) 

Enables or disables EMT logging for the specified EMT(s), where "emt" 
is a valid EMT mnemonic, such as CRE. See System Directives Manual 
for a list of valid EMT mnemonics. 
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/[NOJFMS 

Indicates whether the FMS software is to be loaded upon system 
reboot. After issuing the SET SYSTEM command, you must shutdown 
the system and restart before FMS is available for use. 


/HANGUP={DELAYED | IMMEDIATE} 

Specifies when dial-up lines are placed in an on-hook state when 
carrier is lost. The default is DELAYED, which means the system 
waits approximately five seconds before hanging up a dialup line. 
Setting IMMEDIATE means the system hangs up a dialup line as soon 
as the carrier is dropped. 

/HOLD 

Suspends all currently active jobs except the one issuing the command. 
/LABEL={ANSI | DOS} 

Specifies the tape default label. 

/[NOJLAT 

Indicates whether the LAT software is to be loaded upon system reboot. 


The system must be shut down and restarted after issuing the SET 
SYSTEM command before that state of LAT will change. 


/[NO]LOG 

Used in conjunction with the /EMT_LOGGING qualifier, indicates 
whether to display the status of each EMT specified. The default is 
/LOG. 


/[NOJLOGINS[=n] 

Indicates whether to allow additional logins and specifies the maximum 
number of logged-in users on the system. The minimum abbreviation 
for this qualifier is four characters. The default is job maximum. 


/MONITOR_NAME=name 
Sets the monitor file name that is started the next time the system is 
rebooted. 


/NAME="installation-name" 
Assigns “installation-name" to the system name. The maximum length 
is 15 characters. 


/[NOJPASSWORD_PROMPT[=(typel,...])] 

Indicates whether to enable password prompting and specifies the types 
of users, if any, who must type the system password when logging in. 
Type can be DIALUP and NETWORK. 
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/POWERFAIL_DELAY=n 
Specifies the power fail delay. The valid range for n is 1 to 300. 


/PSEUDO_KEYBOARDS=n 
Specifies the maximum number of static pseudo-keyboards which will 
be available on the system. The minimum value allowed is 1, the 


maximum is 127. The parameter change will take effect upon system 
reboot. The default is /PSEUDO_KEYBOARDS=4. 


/RELEASE 
Resumes execution of all suspended (/HOLD) jobs. 


/[NOJSTATISTICS[=RESET] 

Turns the monitor statistics on and off. Note that this qualifier takes 
effect immediately, and is not stored between system reboots. The 
RESET parameter will reset the statistics counters to 0. The system 
starts with statistics turned off. Once statistics have been turned on, 
the SET SYSTEM/NOSTATISTICS command will cause the statistics 
to be frozen. The SET SYSTEM/STATISTICS command will unfreeze 
them. The default is /NOSTATISTICS. 


/SWAP_MAXIMUM=n 
Sets the value that will be in effect the next time the system is re- 
booted. The minimum value is 34K and the maximum is 66K. 


/TIME_FORMAT=({AM_PM | 24 HOUR} 
Specifies the system time format. 


SET TERMINAL [KB[c]n[:]] 


Allows you to specify the characteristics of a terminal. 


Privilege required: HWCFG to set the characteristics of terminals of 
others or to use the /BUFFER_QUOTA and /PERMANENT qualifiers 


Command Qualifiers 


/[NOJ1382_COLUMNS 
Indicates whether to enable the terminal to display single-width char- 
acters in an array of 24 lines by 132 columns. 
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/INOJADVANCED_VIDEO 

Indicates whether the terminal supports the Advanced Video Option 
(AVO) package that includes character attributes, added screen memory 
and ROM sockets. 


/[NOJALT_MODE 
If you specify /ALT_MODE, the system treats ASCII 027, 125, and, 126 
as ESCAPE; otherwise, the system treats only ASCII 027 as ESCAPE. 


/[NOJANSI 
Indicates whether the terminal supports ANSI escape sequences. 


/INOJANSWERBACK/PERMANENT 

Indicates whether to enable reception of electronic messages on a given 
terminal line. You can use the terminal for normal logins as well. 
/ANSWERBACK is not valid if terminal is set /AUTOBAUD. 


/[NOJAUTOBAUD/PERMANENT 

Indicates whether the system automatically monitors the terminal line 
to detect and set the terminal baud rates. /AUTOBAUD is not valid if 
terminal is set /ANSWERBACK. 


/[NOJBREAK 
Indicates whether to translate the BREAK key as a Ctrl/C character 
(Binary 3) instead of NULL character (Binary 0). 


/[LNOJBROADCAST 
Indicates whether to enable the system broadcast capability for the 
terminal. 


/BUFFER_QUOTA=n 

Specifies the number of input characters the system buffers before 
instructing the terminal to stop transmitting. The valid range for n 
is 168 to 7140, rounded to the nearest multiple of 28. The default is 
/BUFFER_QUOTA=168. 


AINOJCONTROL[=(optionf,...])] 
Indicates how the terminal handles Control key combinations. Options 
can be: 


R Indicates whether to enable the Ctrl/R retype facility 

T Indicates whether to enable the Ctrl/T job status display facility 
C Indicates whether to enable Ctrl/C trapping 

x Indicates whether to enable the Ctrl/X clear type-ahead facility 
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/[INOJCRFILL[=n] 
Indicates whether to enable carriage return filling and specifies the fill 
factor. The valid range for n is 0 to 6. 


/[INO]DELIMITER[=c] 

Specifies a private delimiter or removes a previously specified delimiter. 

The delimiter (c) can be: 

A quoted character The character is the delimiter 

1 to 127 The character whose binary value is the 
specified number is the delimiter 

/DEVICE_TYPE=terminal-type 

Associates the default characteristics with the specified terminal type. 


/[NOJDIALUP/PERMANENT 
Indicates whether to enable modem control for the specified terminal. 


/[NOJEIGHT_BIT 
Indicates whether to allow support of 8-bit characters. 


/[NOJESCAPE_SEQUENCE 

If you specify /ESCAPE_SEQUENCE, the system treats an ESC char- 
acter as an indication of an incoming escape sequence; otherwise, the 
system treats an ESC character as a line terminator. 


/[[INOJFORM_FEED 
Indicates whether to enable hardware form feed and vertical tab 
control. 


/HARDCOPY 
Specifies that the terminal is not a CRT display. 


/INOJHOST_SYNC 

Indicates whether the terminal has special hardware that allows the 
host computer to send XON and XOFF characters. /HOSTSYNC is not 
valid if the terminal is set (RESUME=ANY. 


/INQUIRE 

Interrogates the terminal by sending an ANSI ESCAPE identifying 
sequence, determines the terminal type, and sets the appropriate 
terminal characteristics. 
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/[NOJINSERT 

/[INOJOVERSTRIKE 

Allows you to insert characters (INSERT MODE) when editing a 
command line or type over the current character (OVERSTRIKE 
MODE). This mode becomes the default whenever a new command is 
entered. The default is /OVERSTRIKE. 


/INOJINTERACTIVE/PERMANENT 

Indicates whether the terminal is to be used interactively. If you specify 
/NOINTERACTIVE, the system ignores all input from the terminal but 
the terminal still displays system output. 


/INOJKATAKANA 
Indicates whether the terminal supports the Katakana character set. 


/INOILINE_EDITING 

Indicates whether to enable line editing capabilities on the terminal. 
This qualifier is valid only at the application level; it is ignored at the 
DCL level or at other run-time systems levels. 


/[NOJLOADABLE_CHARACTERS 
Indicates whether the terminal supports dynamically redefinable 
character sets. 


/[NOJLOCAL_ECHO 
Indicates whether to disable echoing of characters received from the 
terminal. 


/LOWERCASE[=INPUT,OUTPUT] 
Enables use of lowercase character for terminal INPUT and/or 
OUTPUT. 


/[NOJOPERATOR_SERVICES[=(keyword[,...])] 

Indicates whether to enable the terminal as an operator services 
console. The keyword argument specifies the type of requests that 
will be broadcast to the specified terminal. Valid keywords are ALL, 
[NOIMESSAGES, [NOJREQUESTS, and NONE. /NOOPERATOR_ 
SERVICES is a synonym for /OPERATOR_SERVICES=NONE. This 
qualifier requires the OPER privilege. 


/ANOJPARITY[=option] 
Indicates whether to enable parity bit checking and specify if parity 
checking is ODD or EVEN. 
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/AINOJPERMANENT 
Indicates whether to modify the terminal’s permanent characteristics 
instead of the terminal’s current characteristics. 


/INOJPRINTER_PORT 
Indicates whether the terminal has a printer port. 


/INOJRECALL 

Indicates whether to enable command recall capabilities on the termi- 
nal. This qualifier is valid only at the application level; it is ignored at 
the DCL level or in other run-time systems. 


/INOJREGIS 
Indicates whether the terminal supports the Remote Graphic 
Instruction Set (ReGIS). 


/RESET 
Resets the terminal characteristics to its permanent characteristics. 


/INOJRESTRICT/PERMANENT 
Indicates whether to restrict terminal access to only those users having 
DEVICE privilege instead of allowing access by all users. 


/RESUME={ANY | CONTROL_C} 

Defines the XON/XOFF processing. The ANY argument enables type- 
out and echo when any character is typed after XOFF. /RESUME=ANY 
is not valid when the terminal is set /HOST_SYNC. The argument 
CONTROL_C enables typeout and echo only when XON or Ctrl/C are 
typed after XOFF. 


/SCOPE 
Specifies the terminal is a CRT display. 


/INO]JSELECT_ERASE 
Indicates whether the terminal supports the selectively erasable 
character attribute. 


/SETUP=filespec 
Specifies a file used to initialize the terminal. 


AINOJSIXEL 
Indicates whether the terminal supports Sixel Graphics. 
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/SPEED=(inputl[,output]) 

/SPEED=n 

Specifies the speed at which the terminal sends (output) and receives 
(input) data. If you use the /(SPEED=n form, n specifies 

and output values. 


/[NOJTAB 
Indicates whether to enable hardware tab control. 


/[NOJTTSYNC 

Indicates whether to inform the host computer to ignore XON and 
XOFF characters sent by the terminal. 

/TYPE=n 

Specifies the terminal’s type code. The valid range for n is 0 to 255, 
with 0 to 128 reserved for DIGITAL’ use. 

/[INOJUP_ARROW 

Indicates whether to inform the system to echo a control and graphic 
character combination as the circumflex (“) character (value 94) 
followed by the proper graphic instead of the control and graphic 
character combination as is. 


/UPPERCASE[=INPUT,OUTPUT] 
Disables use of lowercase character for terminal INPUT and/or 
OUTPUT. 


/[NOJUSER_DEFINED_KEYS 
Indicates whether the terminal supports user-defined keys. 


/WIDTH=n 
Specifies the terminal print line width. The valid range for n is 1 to 
254. 


SET TIME [date:]time 


Sets the system time. You can specify any valid DCL relative or 
absolute date/time string. For additional information on entering dates 
and times, see the section, "Rules for Entering DCL Commands." 


Privilege required: DATES 
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SET VERIFY 


Informs DCL to display lines in a command procedure as it executes 
them. See also SET NOVERIFY. 


Privilege required: none 


Command Qualifier 


/INOJDEBUG 
Indicates whether to enable command debugging. The default is 
/NODEBUG. 


SHOW ACCOUNT [dev:[p,pn]] 


Displays information about one or more accounts. 


Privilege required: GACNT or WACNT to display data for accounts 
other than your own or to reset the accounting data 


Command Qualifiers 


/ACCOUNTING_DATA 
Displays the PPN, account name, allocation, kilo-core-ticks, CPU-time, 
connect time, and device usage time. 


/ALL 

Displays information about all accounts on the disk. If you specify an 
account and this qualifier, the command displays information about the 
specified account only. 


/BRIEF 
Displays the PPN, account name, allocation, account attribute flags, 
last login time, and expiration date. The default is /BRIEF. 


/FULL 
Displays complete information about the account including the User 
File Directory (UFD) Size and UFD Used fields. The default is /BRIEF. 


/[NOJOUTPUT|=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 
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/[NOJRESET 
Resets the accounting data after displaying the account information. 


TAAN Ti 


The defauit is /NORESET. 


/[NOJUSER 

Indicates whether to include only those accounts that have login 
attributes instead of those accounts that do not have login attributes. 
The default is all accounts. 


SHOW BUFFERS 


Displays information about buffer usage on your system. 


Privilege required: none 


Command Qualifier 


/INOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW CACHE 


Displays the current cache settings. 


Privilege required: none 


Command Qualifier 


/[NOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW COMMAND/SYSTEM [command-name] 


Displays information about a Concise Command Language (CCL) or 
systemwide command. 


Privilege required: INSTAL 
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Command Qualifier 


/ALL 
Displays information about all systemwide commands. 


/INO]OUTPUT([=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW COUNTERSILAT [server-name] 


Displays information about counters that is relevant to managing 
LAT on the host node. There are three types of counter information: 
LAT host node counters, Terminal Server counters, and Ethernet 
portal counters. These are displayed using the /NODE, /TERMINAL_ 
SERVER, or /DEVICE qualifiers. Only one of these qualifiers may 
appear on the command line. 


Privilege required: SWCTL to use the /ZERO qualifier. 


Command Qualifiers 


/DEVICE 
Displays information about counters for all Ethernet portals open for 
LAT service. 


/NODE 
Displays information about counters for the LAT host node. /NODE is 
the default if neither /DEVICE nor /TERMINAL_SERVER is specified. 


/[[NOJOUTPUT{[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


/TERMINAL_SERVER 

Displays information for counters for the terminal server(s) known to 
the LAT host node. If a server name parameter is specified, only the 
counters for that server are displayed. If no parameter is specified, 
then counters for all servers known to the LAT host node are displayed. 
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/ZERO 
Zeroes the counters after they are displayed. This qualifier acts only on 
the counters that are being displayed. 


SHOW DATE 
Displays the current date and time. You can use the OPEN/LOG_FILE 
command to create a log file to save the output. 


Privilege required: none 


SHOW DAYTIME 


Displays the current date and time. You can use the OPEN/L 


command to create a log file to save the output. 


Privilege required: none 


SHOW DEVICE [dev[:jj 


Displays information about one or more devices. 


Privilege required: none 


Command Qualifier 


/ALL 
Displays information about all devices on the system. 


/ALLOCATED 
Displays information about all devices that are currently open or 
allocated. 


/[LNOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 
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SHOW DEVICE/ALLOCATED 
Displays information about devices currently opened or allocated by 
jobs on the system. 


Privilege required: none 


Command Qualifier 


(INOJOUTPUT|[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW DISKS 


Displays the status of disks currently mounted or open on your system. 


Privilege required: none 


Command Qualifier 


/INOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW ENTRY [entry-spec | entry-number] 


Displays information about one or more print or batch entries. 


Privilege required: WREAD for entries you do not own 


Command Qualifiers 


/ALL 


Displays the status of all entries. This is equivalent to an entry-spec of 
cat tad al 


/BATCH 
Displays the status of batch queue entries only. 
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/BRIEF 

Displays with column headings the position, type, number, queue name, 
owner account number, eniry name, eniry form name, and status using 
a one-entry-per-line format. The default is /BRIEF. 


/BY_JOB_STATUS[=(keyword[,...])] 

Displays all of the entries in PRINT or BATCH queues with the 
specified status that are currently being processed or waiting to be 
processed. /BY_JOB_STATUS is supported for VMS compatibility and 
is a synonym for /STATUS. Keyword represents the status of entries to 
be displayed; keyword can be: 


TIME_RELEASE Displays entries with the status AFTER; indicates they 
are waiting for their specified after date-time to elapse. 

HOLDING Displays entries with the status HOLD; indicates they 
cannot start until they are taken off HOLD status via 
the SET ENTRY/RELEASE command. 

PENDING Displays entries with the status READY; indicates 


they are waiting for a print or batch server to become 
available for processing. 


EXECUTING Displays entries with the status STARTED; indicates 
they are currently being processed by a print or batch 
server. 

/FILES 

Displays all filespecs and their qualifiers for the entry. 

/FULL 


Displays the position, type, number, queue name, owner account 
number, entry name, and status, priority, date/time of submission, 
date/time of modification, date/time entry started, the after date/time, 
the server name, and whether or not the PRINT or SUBMIT command 
included the /NOTIFY qualifier. The default is /BRIEF. 


/INOJOUTPUT|[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


/PRINT 
Displays the status of print queue entries only. 
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/STATUS[=(keyword[,...])] 

Displays all of the entries in PRINT or BATCH queues with the 
specified status that are currently being processed or waiting to be 
processed. Keyword represents the status of entries to be displayed; 
keyword can be: 


AFTER Indicates entries that are waiting for their specified after 
date-time to elapse. 

ABORTING Indicates entries that have started but are being termi- 
nated. 

FORMS_WAIT Indicates print entries that are waiting for their required 
form to be installed on an assigned print server. 

HOLD Indicates entries that are on hold until the SET 
ENTRY/RELEASE command is issued. 

READY Indicates entries that are waiting for a print or batch 
server to become available for processing. 

STARTED Indicates entries that are currently being processed by a 


print or batch server. 


SHOW FILES/OPEN [disk-name[:]] 


Displays the status of files open on the system or the specified disk. 
Privilege required: WREAD 


Command Qualifiers 


/JOB[=n] 
Displays the job numbers of the jobs that have open files. Specifying a 
job number limits the display to files opened by that job. 


ANOJOUTPUTT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW FILE/SYSTEM 


Displays information about one or more system files. 


Privilege required: none 
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Command Qualifiers 


/ALL 
Displays information about all system files. 


/ERROR_FILE 
Displays information about the system error file. 


/NETWORK_FILE 
Displays information about the network database file. 


/[NOJOUTPUTI=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


/OVERLAY_FILE 
Displays information about the overlay file. 


/SWAP FILE [=n] 
Displays information about the specified swap file. The value of n can 
be 0, 1, or 3. The default is all swap files. 


SHOW JOB [job-number] 


Displays information about the status of jobs on the system. 


Privilege required: TUNE to display a job’s priority and run burst 


Command Qualifiers 


/ALL 
Displays status of all jobs. 


/ATTACHED 
Displays status of attached jobs only. 


/DETACHED 
Displays status of detached jobs only. 


/[NOJOUTPUT|[=filespec] 

Writes the information to the specified file. If you specify /(NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 
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/TERMINAL=KB{clnI(:] 
Displays the status of the job attached to the specified keyboard. 


SHOW JOB/PRIVILEGE [job-number] 


Displays the set of current privileges for your job or another job. 
Privilege required: 

¢ None to display privileges for a job you own 

¢ JOBCTL to display privileges for a job not your own 
Command Qualifiers 


/[INOJOUTPUT{[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW LIBRARY 


Displays the status of resident libraries currently installed on your 
system. 


Privilege required: none 


Command Qualifier 


ANOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW LOGICALS [logical-name] 


Displays all the currently assigned systemwide and user-defined logical 
names. You can include wildcards when specifying a logical name. 


Privilege required: none 
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Command Qualifier 


/ALL 
Displays information about all systemwide and user-defined logical 
names. /ALL is the default. 


/INOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


/SYSTEM 
Displays all systemwide logical names. 
/USER 


Displays your currently assigned logical names. 


SHOW MEMORY 


Displays the current memory configuration of your system. 


Privilege required: none 


Command Qualifier 


/[INOJOUTPUTI=filespec] 

Writes the information to the specified file. If you specify /(NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW NETWORK 


Displays the systems you can cennect to over the network. If the 
network is operational, RSTS/E displays the names of the nodes that 
your system can access. You can use the OPEN/LOG_FILE command 
create a log file to save the output. 


Privilege required: none 
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SHOW NODE/LAT 


Displays information about the current LAT host node characteristics. 
The information displayed includes the LAT version number, the node 
name and identification, the multicast timer, the groups to which the 
LAT host node is associated, and the Ethernet line(s) on which LAT is 
enabled. 


Privilege required: none 


Command Qualifier 


ANOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW OPERATOR_SERVICES 


Displays the current status of the Operator/Message Services (OMS) 
package (the current version, the types of requests being stored in the 
work file, and the status of all operator services consoles currently 
defined on the system). 


Privilege required: none 


/[NOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW PORT [port-name] 


Displays the characteristics of LAT ports on the RSTS/E node. The 
default is to display both interactive and application ports. The system 
displays the local port name, the port type (interactive or application), 
the queued setting, the terminal server name, the remote service (if 
specified), the remote port (if specified), and the connection status. 


If the port is not assigned to a terminal! server, only the lecal port name 
and type are displayed. 
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If the port is assigned, but not vet connected, the terminal server, the 
remote service, and the remote port are displayed. 


If the port is waiting to connect, the connection status "In Progress" 
is displayed; if the connection is queued, the queue position is also 
displayed. 


If the port is connected, the terminal server, the remote service, the 
remote port, and the job number are displayed. 


If the port is allocated, the current queued setting is displayed. 
Otherwise, the default setting, either queued or noqueued, is displayed. 


An asterisk (*) is displayed after the local port name if it is a dial-up 
line. 

The port-name parameter specifies the name of the port for which the 
characteristics are displayed. The port-name must be in the form of 


KBI n: or KBn:, where n is a vaiue from 0 to 127. If no port name is 
specified, then the characteristics for all LAT ports will be displayed. 


Privilege required: none 


Command Quaiifiers 


/ALL 
Generates a display of all LAT ports, both application and interactive. 
/ALL is the default. 


/INOJAPPLICATION 

Generates a display of all LAT application ports. This qualifier is 
ignored if a port name is specified. If you specify /NOAPPLICATION, 
then only interactive ports are displayed. 


/INOJINTERACTIVE 

Generates a display of all LAT interactive ports. This qualifier is 
ignored if a port name is specified. If you specify /NOAPPLICATION, 
then only application ports are displayed. 


/LAT 
Indicates that LAT ports are to be displayed. /LAT is the default. 


[AINOJOUTPUT|=filespec] 

Controls where the output of the command is sent. If the qualifier 
is not specified, or /OUTPUT is used without a file specification, the 
output is sent to the user’s terminal. 
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If you specify /NOOUTPUT, then the output is suppressed. 


SHOW PRINTER [dev{[:]] 


Displays the characteristics of an LP-type printer. 


Privilege required: none 


Command Qualifier 


/ALL 
Displays the characteristics of all LP-type printers on the system. 


/[[NOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW QUEUE [queue-name[:]] 


Displays the status and attributes of one or more print or batch queues. 


Privilege required: none 


Command Qualifiers 


/ALL 
Displays the status of all queues. 


/BATCH 
Displays the status of batch queues only. 


/BRIEF 
Displays the queue name, type, and status only. The default is /BRIEF. 


/FULL 

Displays the queue name, privileges, type, status, the default forms 
name for print queues, the default and maximum priorities, the default 
and maximum page limits for print queues, the default and maximum 
CPU limits for batch queues, the default and maximum time limits for 
batch queues, and the assigned queue servers. The default is /BRIEF. 
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/[NOJOUTPUTI=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


/PRINT 
Displays the status of print queues only. 


SHOW RECEIVERS 


Displays the status of declared message receivers on your system. 


Privilege required: none 


/[NOJOUTPUTI=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional! filespec 
argument is omitted, the output displays on the terminal. 


SHOW REQUESTS 


Displays messages, requests, and replies to requests stored in the 
Operator/Message Services (OMS) work file. 


Privilege required: OPER 


Command Qualifier 


/ALL 

Displays both messages and requests. This qualifier conflicts with 
the (INOJREPLY qualifier. If both qualifiers are specified on the same 
command line, only the rightmost qualifier is used. 


/BEFORE=date-time 

Displays messages or requests or both made before the specified date 
and time. Either an absolute or relative date and time can be specified. 
If no date is specified, then TODAY is used. If no time is specified, then 
12:00AM is used. 
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/BRIEF 

When displaying requests made with the /REPLY qualifier, only re- 
quests will be displayed. This qualifier conflicts with the /FULL 
qualifier. If both qualifiers are specified on the same command line, 
the rightmost qualifier is used. 


/INOJEXACT 

Controls whether the text specified with the /TEXT qualifier matches 
the text of a request exactly or treats uppercase and lowercase letters 
as equivalents. By default, case differences in letters are ignored. 


/FACILITY=(facility-list) 

Displays messages or requests or both made from the specified fa- 
cilities. Up to eight facilities can be specified. Parentheses are not 
required when only one facility is specified. 


The NO prefix can be used to display messages or requests or both from 
facilities other than those specified. For example, /FACILITY=(LOGIN, 
LOGOUT) displays only messages from the LOGIN and LOGOUT 
programs. /FACILITY=(NOPBS,NOOMS) displays all messages or 
requests or both from facilities other than PBS and OMS. If you use 
the NO prefix with one facility name, you must specify it on all the 
facility names in the list. 


/FULL 

Indicates that replies to requests are displayed. This qualifier conflicts 
with the /BRIEF qualifier. If both qualifiers are specified on the same 
command line, the rightmost qualifier is used. 


AINNPUT=filespec 

Selects an alternate input file (or files) to be examined. Can be used to 
display requests from a previous OMS log file. Wildcards are allowed 
for the file name and extension fields. You must have read access to the 
file specified. 


If this qualifier is not specified, requests are displayed from the current 
OMS log file, OMS$:REQLOG.OMS. 


/JOB=job-number 

Displays messages or requests made by the specified job-number. 
[INOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


2-136 DCL Commands 


/[NOJREPLY 
Indicates whether messages or requests are displayed. /NOREPLY is 
used to display messages. The default is /ALL. 


/SINCE=date-time 

Displays messages or requests or both made since the specified date 
and time. Either an absolute or relative date and time can be specified. 
If no date is specified, then TODAY is used. If no time is specified, then 
11:59PM is used. 


/TERMINAL=KBi[cln[:] 

Displays messages or requests or both made from the specified termi- 
nal. The keyword DETACHED can be specified in place of the device 
name to select requests made by detached jobs. 


/TEXT=["Istring["] 
Displays messages or requests or both containing the specified string. 
Enclose strings containing lowercase letters or nonalphanumeric char- 
acters (including spaces) in quotation marks. You can use the /EXACT 
qualifier to alter the way that the text string is matched against the 
text of a message or request. 

/USER=[p,pn] 


Displays messages or requests made by the specified user. 


SHOW RUNTIME_SYSTEM 


Displays the status of currently installed run-time systems. 


Privilege required: none 


Command Qualifier 


ANOJOUTPUT|=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 
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SHOW SERVER [server-name[:]] 


Displays the status and attributes of one or more print or batch servers. 


Privilege required: none 


Command Qualifiers 


/ALL 
Displays the status of all servers. 


/BATCH 
Displays the status of batch servers only. 


/BRIEF 
Displays the server name, type, and status only. The default is /BRIEF. 


/FULL 
Displays the server name, type, status, current entry, and assigned 
queues. The default is /BRIEF. 


/[NOJOUTPUT|=filespec] 
Writes the information to the specified file. If you specify /NOOUTPUT, 


the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


/PRINT 
Displays the status for print servers only. 


SHOW SERVICES/LAT [service-name] 


Displays information about the service(s) offered by the LAT host 
node. If a service name is specified, only that service will be displayed. 
Otherwise, all services offered by the LAT host will be displayed. 


Privilege required: none 


Command Qualifier 


/[NOJOUTPUT{[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 
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SHOW SESSIONS [server-name] 


Displays information about the sessions currently running LAT on the 
host node. The server name is optional and, if omitted, information is 
displayed about all servers known to RSTS. The information includes 
the RSTS keyboard number of the terminal on which the user is logged 
in, the terminal server on which the user is physically connected, and 
the name of the service the user is currently running. An asterisk (*) 
appears after the keyboard number if the session was started from a 
dialup LAT line. 


Command Qualifiers 


/DEViCH=Ethernet-device: 
Restricts the search to those users who are currently running LAT on 
the particular Ethernet device specified. 


/LAT 
Indicates that LAT sessions are to be displayed. /LAT is the default. 


A[NOJOUTPUT|=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW SYMBOL [symbol-name] 


Displays the value of one or more DCL local or global symbols. You 
can use the OPEN/LOG_FILE command to create a log file to save the 
output. 


Privilege required: none 


Command Qualifiers 


/ALL 
Displays the value of all symbols in the specified symbol table. 


/GLOBAL 
Displays the value of the specified global symbol. 


/LOCAL 
Displays the value of the specified local symbol. 
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SHOW SYSTEM 


Displays the specified system default characteristics. 


Privilege required: none 


Command Qualifiers 


/EMT_LOGGING 
Displays the status of each EMT specified. 


/[INOJOUTPUT[=filespec] 

Writes the information to the specified file. If you specify /(NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW TERMINAL [KB[c]n[:]] 


Displays the characteristics of your terminal or another terminal. 
Privilege required: 


¢ None to display the characteristics of your own terminal 


¢ HWCFG to display the characteristics of terminals other than your 
own 


Command Qualifiers 


/ALL 
Displays the characteristics of all terminals on the system. 


/BRIEF 
Displays a subset of the terminal characteristics. The default is 
/BRIEF. 


/FULL 
Displays the full set of terminal characteristics. The default is /BRIEF. 


AINOJOUTPUT|=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 
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/[NOJPERMANENT 
Indicates whether to display the permanent terminal characteris- 
tics instead of the current terminal characteristics. The default is 


/NOPERMANENT. 


SHOW TERMINAL_SERVERSI/LAT [server-name] 


Displays information about the terminal server(s) known to the LAT 
host node. The server name is optional and, if omitted, information is 
displayed about all servers known to RSTS. 

Command Qualifier 


/[INOJOUTPUT[=filespec] 

Writes the information to the specified file. if you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 


SHOW TIME 


Displays the current date and time. You can use the OPEN/LOG_FILE 
command to create a log file to save the output. 


Privilege required: none 


SHOW USER [[p,pn]] 


Displays the status of one or more users on the system. 

Privilege required: TUNE to display information about a user’s priority 
and run burst attributes 

Command Qualifiers 


/ALL 
Displays the status for all users. 


/ATTACHED 
Displays the status for all attached jobs. 
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/DETACHED 
Displays the status for all detached jobs. 


/[[NOJOUTPUT{=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, 
the information is suppressed and not displayed. If the optional filespec 
argument is omitted, the output displays on the terminal. 
/TERMINAL=KB[c]n[:] 

Displays the status of the job attached to the specified keyboard. 


SORT input-filespec[,...] output-filespec 


Invokes the PDP-11 SORT Utility to reorder the records in one or more 
input files into a single output file. 


Privilege required: none 


Command Qualifiers 


/COLLATING_SEQUENCE={ASCII | EBCDIC | MULTINATIONAL} 
Specifies the collating sequence. The default is /COLLATING_ 
SEQUENCE=ASCII. 


/[NOJDUPLICATES 
Indicates whether to allow duplicate record keys. The default is 
/DUPLICATES. 


/KEY=(field{,...]) 
Specifies one or more sort keys. 


/PROCESS={ADDRESS | INDEX | RECORD | TAG} 
Specifies the sort type. The default is /PROCESS=RECORD. 


/SPECIFICATION[=filespec] 
Specifies the name of a SORT specification file containing SORT com- 
mand qualifiers and other instructions. 


/[NOJSTABLE 
Indicates whether to keep records having equal keys in their original 
order. 


/AINOJSTATISTICS 
Indicates whether to display a statistical summary afte 


operation completes. The default is /NOSTATISTICS. 
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/WORK_FILES=([NUMBER=n][, DEVICE=dev{[:[ppn]]] 

[, ALLOCATION=m][,[NO]JCONTIGUOUS]L,SIZE=s]) 

Specifies the number of temporary work files you want to use during 
the sort process, an alternate device and directory where you want to 
assign the files and options to optimize the files. The valid values for n 
are 0 and 3 to 10. The valid range for m is 1 to 4294967295. The valid 
range for s is 1 to 255. 


Input File Qualifiers 


/FORMAT=(record-formattf,...]) 
Specifies the record format of the input or output file to override the 
existing data that SORT normally obtains through RMS-11. 


/INDEXED_SEQUENTIAL/=n] 


a oe at 4¢hat +h : : : 
Specifies that the organization of the input or output fi 2 a 


sequential and the number of keys used. 
/INOJISHAREABLE 


Indicates whether the input file can be opened in a write-shareable 
mode. 

/TREE_SPACE=n 

Specifies the percentage of the work area for use by the SORT tree data 


structure. The valid range for n is 1 to 100. The default is 
TREE_SPACE=55. 


Output File Qualifiers 


/ALLOCATION=n 
Specifies the number of 512-byte blocks allocated for the output file. 
The valid range for n is 1 to 4294967295. 


/BUCKET_SIZE=n 
Specifies the number of 512-byte blocks per bucket for the output file. 
The valid range for n is 1 to 15. The default is /BUCKET_SIZE=1. 


/[INOJCONTIGUOUS 
Indicates that the output file disk space allocation is contiguous. The 
default is /NOCONTIGUOUS. 


/FORMAT=(record-formatf,...]) 
Specifies the record format of the input or output file to override the 
existing data that SORT normally obtains through RMS-11. 
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/AINDEXED_SEQUENTIAL[=n] 
Specifies that the organization of the input or output file is indexed- 
sequential and the number of keys used. 


/LOAD_FILL 
Loads the buckets according to the fill size established when the disk 
file was created. 


/INOJOVERLAY 
Indicates whether to overlay the existing file with the sorted records of 
the input file. The default is /NOOVERLAY. 


/RELATIVE 
Specifies that the organization of the output file is relative. 


/SEQUENTIAL 
Specifies that the organization of the output file is sequential. 


START/LAT Ethernet-device: 


Starts up LAT on the specified Ethernet device. Note that Ethernet 
devices can only be XHO: or XEO: (UNA/LUA-0 or QNA/LQA-0). It is 
required that a SET NODE/LAT command be executed prior to issuing 
the first START/LAT command. 


Privilege required: SWCTL 


Command Qualifiers 


/[NOJLOG 
Indicates whether to display a confirmation message indicating that 
LAT has started up. The default is /LOG. 


START/OPERATOR_SERVICES 
Starts the Operator/Message Services (OMS) package. Include this 


command in the system start command file (START.COM) to make 
operator services available during timesharing. 


Privilege required: SWCTL and OPER 
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Command Qualifier 

A NOTKEEP=(keyword],...}) 

Specifies the type of requests that will be kept in the operator services 
work file. Valid keywords are ALL, [NOJMESSAGES, [NOJREQUESTS, 
and NONE. The /NOKEEP qualifier is a synonym for /KEEP=NONE. 


/PRIORITY=n 

Specifies the priority of the operator services job. By default, OMS is 
started at priority -8, the default system priority. You can specify any 
priority value in the range -120 to +120. If necessary, OMS will round 
the value to the next lower multiple of 8. 


/RUN_BURST=n 
specify any run burst value in the range 1 to 127. 


START/QUEUE queue-name{:] 


Restarts a queue that has been stopped. 
Privilege required: PBSCTL 


START/QUEUE/MANAGER 


Starts the Print/Batch Services (PBS) facility. 
Privilege required: PBSCTL 


Command Qualifiers 


/PRIORITY=n 

Specifies the priority of the PBS primary and secondary jobs. The valid 
range for n is -120 to +120, which is rounded down to a multiple of 8. 
The default is /PRIORITY=-8. 


/RUN_BURST=n 
Specifies the run burst of the PBS primary and secondary jobs. The 
valid range for n is 1 to 127. The default is /RUN_BURST=6. 
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START/SERVER sServer-name[:] 


STOP 


Starts a server that was stopped using the STOP/SERVER command. 
Privilege required: PBSCTL 


Command Qualifiers 


/BACKSPACE[=n] 

Restarts the current print job n pages back in the current file copy. If 
you do not specify n, printing resumes one page back in the current file 
copy. 


/FORWARDSPACE[=n]} 

Restarts the current print job n pages forward in the current file copy. 
If you do not specify n, the default is that printing resumes one page 
forward in the current file copy. 


/NEXT_JOB 
Resumes printing or batch processing at the beginning of the next job, 
thus terminating the current job. 


/PAGE=n 
Restarts the current print job at page n in the current file copy. 


/RESTART 
Restarts the current print job at the beginning of the current job copy. 


/TOP_OF_FILE 
Starts the current print job at the beginning of the current file copy. 


Ends a command procedure and immediately returns control to the 
interactive command level. 


Privilege required: none 
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STOP/LAT [Ethernet-device:] 


Disables LAT service on a particular Ethernet device or on all Ethernet 
devices. If no Ethernet-device parameter is specified, LAT is disabled 
on all Ethernet devices. All jobs running on an Ethernet device that is 
to be disabled will detach. 


Command Qualifier 
/[NOJLOG 


Indicates whether to display a confirmation message indicating that 
LAT has stopped. The default is /LOG. 


Manually shuts down the Operator/Message Services (OMS) package in 
an orderly manner, either immediately or after all currently pending 
requests have been completed. 


Privilege required: SWCTL and OPER 


Command Qualifier 


/(INOJABORT 
Indicates whether to abort any requests that are currently pending, or 
allow them to complete before shutting down the package. /NOABORT 
is the default. 


STOP/QUEUE queue-name[:] 


Stops a queue to prevent Print/Batch Services (PBS) from processing 
any pending requests. 


Privilege required: PBSCTL 
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STOP/QUEUE/MANAGER 


Shuts down the Print/Batch Services (PBS) facility. If you specify 
/ABORT, RSTS/E shuts down PBS immediately; otherwise, PBS pro- 
cesses all currently active jobs and then shuts down. 


Privilege required: PBSCTL 


Command Qualifier 
/[NOJABORT 


Indicates whether to immediately terminate queue processing, thus 
aborting all currently active jobs. The default is /NOABORT. 


STOP/SERVER server-name[:] 
Stops a print or batch server, preventing the processing of any new 
requests. 


Privilege required: PBSCTL 


Command Qualifiers 


/FILE_END 
Stops the print server after printing the current file copy. 


/JOB_END 
Stops the batch or print server after finishing the current batch or 
print job. 


/PAGE_END 
Stops the print server after printing the current page. 


SUBMIT filespec[,...] [entry-spec] 


Enters a request for batch processing of one or more DCL command 
procedures and places the request on a batch queue. 


Privilege required: 


e Read access to the command files you are submitting 
¢ Write access to use the /DELETE qualifier 
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¢ GACNT to specify another owner in your group 
¢ WACNT to specify another owner not in your group 


Command Qualifiers 

/AFTER=date:time 

Specifies a date:time value after which the entry is eligible for batch 
processing. 

/CPU_LIMIT=n 


Specifies the maximum CPU time, in minutes, allowed for the batch 
job. The valid range for n is 1 to 65535, in addition to UNLIMITED. 


/HOLD 
Places the entry in a "hold" state. To process the entry, you must 
release the entry using the SET ENTRY/RELEASE command. 


AINOJLOG_DELETE 

Indicates whether to delete the log file after printing. The default is 
/NOLOG_DELETE. 

/INOJLOG_FILE[=filespec] 

Indicates whether to create and specify a log file for the batch job. The 
default is /LOG_FILE. 


[INOJLOG_QUEUE[=queue-name] . 

Indicates whether to queue the log file for printing when batch pro- 
cessing is completed and specifies the log file name. The default is 
/NOLOG_QUEUE. 


/NAME=entry-name 
Assigns a name to the entry. 


/INOJNOTIFY 
Indicates whether to notify your terminal session of events that occur 
related to your batch entry. The default is /NONOTIFY. 


/OWNER= [p,pn] 
Specifies the owner of the request. 


/PARAMETERS=(parameterf,...]) 
Specifies from 1 to 8 optional parameters you want to pass to the job. 
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/PRIORITY=n 

Specifies the priority you want to assign to the request. The valid 
range for n is 1 to 255. You cannot specify a value for n that is higher 
than the maximum priority assigned to the queue. 
/QUEUE=queue-name 

Specifies the name of the queue that you want to process the entry. 
/TIME_LIMIT=n 

Specifies the maximum elapsed time, in minutes, you want to allow for 
the requested batch job. The valid range for n is 1 to 65535, in addition 
to UNLIMITED. 


File Qualifier 


/(NOJDELETE 
Indicates whether to delete the command file after processing is com- 
pleted. The default is /NODELETE. 


TYPE [node::]filespec[,...] 


Displays the contents of a text file on your terminal. 
Privilege required: Read access to the file you are displaying 


Command Qualifiers 


/BEFORE=date 

/CREATED 

/MODIFIED 

/SINCE=date 

Displays the files created or modified before or since the specified date. 


/[NOJCONFIRM 
Indicates whether to prompt before displaying each file and is a syn- 
onym for /[NO]JQUERY. 


/INOJLOG NN 
Indicates whether to display a confirmation message on your terminal 
for each file displayed. The default is /NOLOG. 


/INOJQUERY N 
indicates whether to prompt before displaying each file and is a syn- 
onym for /[NOJCONFIRM. 
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=SIZE=MINIMUM=n 

=SIZE=MAXIMUM=n 
=SIZE=(MINIMUM=m,MAXIMUM=n) 
Selects files based on their size. The specified size can be: 


{ =SIZE=n 
/SELECT | 


n Selects only those files with size equal to n. 

MINIMUM=n Selects only those files with size greater 
than or equal to n. 

MAXIMUM=n Selects only those files with size less than 
or equal to n. 

MINIMUM=m,MAXIMUM=n Selects only those files with size between m 


and n inclusive. 


UNLOAD/INDEX [dev{:]} 


Unloads a disk’s SAT (Storage Allocation Table) from memory. 


If you do not specify a device name, the default is the system disk 
(SY0:). 


Privilege required: SWCTL 


UNLOAD/LIBRARY library-name 


Unloads a resident library from memory. 


Privilege required: INSTAL 


UNLOAD/OVERLAY overlay-namef{,...] 


Unloads one or more monitor overlays from memory. See 
LOAD/OVERLAY for a list of valid overlay names. 


Privilege required: SWCFG 


Command Qualifier 


/ALL 
Unloads all overlay monitors. 
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UNLOAD/RUNTIME_SYSTEM name 


Unloads a run-time system from memory. 
Privilege required: INSTAL 


WAIT [delta-time] 


Places the current job in a wait state until a specified period of time 
has elapsed. The WAIT command is useful in DCL command files that 
wish to suspend execution for some period of time. 


The optional parameter delta-time specifies hours, minutes, and sec- 
onds using the format: hh:mm:ss. If not specified, the delta-time 
00:00:00 is used. 


The maximum value that can be specified for each field is: 23 for hours, 
59 for minutes, and 59 for seconds. Specify 60 minutes as 01:00:00 (one 
hour). 


Fields of the delta-time may be omitted but the delta-time must not 
begin with a colon even if the number of hours is zero. 


Privilege required: none 


WRITE channel-number data{,...] 
Writes records to a file you open for writing or appending using the 
OPEN command. 


Privilege required: none 


Command Qualifier 


/[NOJDELIMITER 

Specifies what type of string delimiter WRITE uses. By default, WRITE 
places CR LF characters at the end of the data it writes. When you 
specify /(NODELIMITER, WRITE writes the data as a single string or 
places a specified delimiter at the end of the data. 
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Chapter 3 


DCL Functions 


This chapter provides information on DCL functions. Use DCL func- 


py Wee pare ype 


tions to manipulate strings or integers or return information about 
a file, a job, or the system. You can use DCL functions in the same 
places you use symbols, expressions, or literal values. In command 
procedures, DCL functions perform operations such as: 


¢ Translating logical names 
* Manipulating strings 


¢ Determining the current processing mode of the procedure 


Format of DCL Functions 


A DCL function has the general format: 


F$function-name((arg,...]) 


where: 

F$ Indicates a DCL function. 

function-name Is the function DCL evaluates. You can truncate function 
names to any unique abbreviation with a minimum of two 
characters. 

() Are parentheses that enclose function arguments. You 
do not need to include parentheses if the function has no 
arguments. 
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arg,... Specifies one or more function arguments, if any. Function 
arguments can consist of symbols, integer expressions, 
string expressions, or other DCL functions. 


DCL performs automatic symbol substitution on all function argu- 
ments. Therefore, when you use a symbol name as a DCL function 
argument, you should not enclose the symbol name in apostrophes. 


In some cases, one or more arguments are optional. If an argument is 
optional, you can exclude it from the argument list. You can also use 
commas to indicate which argument you are excluding from the list. 
For example, the F$PARSE function has three optional arguments. You 
can specify the first argument only, as follows: 


F SPARSE (ARG1) 


In this example, you do not specify the second and third arguments. 
You could also use commas to indicate that you are excluding the 
second and third arguments. For example: 


FSPARSE (ARG1,,) 


To specify the first and second arguments but omit the third, you can 
use either format: 


F SPARSE (ARG1, ARG2) 
F SPARSE (ARG1, ARG2, ) 


To specify the first and third arguments but omit the second, you must 
use commas to separate the arguments. For example: 


FSPARSE (ARG1, , ARG3) 


If a function accepts arguments but you omit all arguments, you can 
also omit the parentheses. 


Note that in some cases, specifying an argument as a NULL string or 
as the integer zero is not the same as excluding the argument from an 
argument list. 


This section shows the format and briefly describes each of the DCL 
functions. See the RSTS/E Guide to Writing Command Procedures for 
complete descriptions of the DCL functions. 
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FSACCESS 


access-mode=F$ACCESS 


Returns one of BATCH, DIALUP, LOCAL, NETWORK, or SERVER 
indicating the current job access mode. 


FSASCII 

number = F$ASCli(siring) 

Converts the first character in a string to its ASCII value. 
FSCHR 

string = FSCHR(number) 

Converts an integer to an ASCII character. 
FSCVTIME 

string = F$CVTIME([date]) 

Converts a date-time string to a string suitable for comparisons. 
FSEDIT 

string = F$EDIT(string,edit-code) 

Edits a string. See Table 3-1 for a description of valid edit-codes. 
FSENVIRONMENT 


value = FSENVIRONMENT(keyword) 


Returns information regarding the current job environment. See 
Table 3—2 for a description of keywords and return values. 
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FSINSTR 


position = FSINSTR(position,string substring) 


Returns the location of a substring. 


FSINTEGER 


number = FSINTEGER(string) 


Converts a string to an integer. 


-F$JOB 
job-number = F$JOB 
Returns the current job number. 
FSLEFT 
substring = F$LEFT(string,position) 
Extracts a substring from a string, beginning at position 1 and ending 
at the position you specify. 
FS$LENGTH 
length = FSLENGTH(string) 
Returns the length of a string. 
FS$MESSAGE 


text = FSMESSAGE(error-number) 


Returns the message text associated with a RSTS/E error number. 
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F$MID 


FSNODE 


FSPARSE 


string = F$MID(string,position,length) 


Extracts a substring from a string beginning at the position you specify. 


node-name = FSNODE 


Returns the current DECnet node name. 


filespec = F$PARSE([filespec],[default-spec], [field]) 


Returns a complete RSTS/E file specification or a specified field within 
the file specification. See Table 3-3 for a description of valid field 
keywords. 


FSPRIVILEGE 


FSRIGHT 


FSSEARCH 


truth-value = FSPRIVILEGE(privilege-list) 


Returns the status of a job’s privileges. 


substring = FSRIGHT(string,position) 


Extracts a substring from a string, beginning at the position you 
specify, and ending at the rightmost position of the string. 


filespec = FSSEARCH([filespec]) 


Searches a disk directory for a file and returns the complete RSTS/E 
file specification of the next occurrence of the file. 
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FSSTRING 
string = F$STRING(number) 


Converts an integer to a string. 


FSTERMINAL 


keyboard_number = F$TERMINAL | 
Returns the keyboard number for your job. 


FSTIME 
date = F$TIME 
Returns the current time and date. 
FSTYPE 
type = FSTYPE(expression) 
Returns one of STRING, INTEGER, or the NULL STRING indicating 
the type of a symbol or expression. 
FSUSER 
ppn = FSUSER 
Returns the project-programmer number for your job. 
FSVERIFY 


old-setting = F$VERIFY([new-setting]) 


Enables or disables the verification setting and returns the previous 
setting. 
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Table 3-1 lists the edit-code values for FSEDIT. 


Table 3-1: Edit-Code Values for FSEDIT Function 


Edit-Code Effect 
2 Discards spaces and tabs. 
4 Discards RET, LF, FF, ESC, DEL, and fill or null charac- 
ters. 
8 Discards leading spaces and tabs. 
16 Reduces spaces and tabs to one space. 
32 Converts lowercase to uppercase. 
64 Converts square brackeis to parentheses. For exampie, 
"[" to "(" and "J" to ")". 
128 Discards trailing spaces and tabs. 
256 Prevents alteration of characters inside single or double 


quotation marks, except parity bit trimming. 
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Table 3-2 lists the keywords and return values for FSENVIRONMENT. 


Table 3-2: 
Keyword 


CAPTIVE 
CONTROL 


DATA 


DEFAULT 


DEPTH 


ECHO 


FREE_CHANNELS 
INTERACTIVE 


LOG_FILE 
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Type 


string 
string 


string 


string 


integer 


string 


integer 


string 


string 


Keywords and Return Values for FSENVIRONMENT Function 


Description 


Returns “TRUE” if executing in a captive account, or 
“FALSE” otherwise. 


Returns "" if SET NOCONTROLEC is in effect or at the 
interactive level, or “C” if SET CONTROL=C is in effect. 


Returns current SET DATA status. Possible values are: 


one 


Job is at interactive 
level 


SET DATA is in 
effect with end of 
data character “$” 
SET DATA is in 
effect; "x" is the 
currently defined 
end-of-data character 


SET NODATA is in 
effect 


Returns the user’s account; the account you are logged in 
to. 


“DATA” 


“DATA/END_OF_DATA="x"” 


“NODATA” 


Returns current command procedure depth level. The 
DCL command prompt (interactive) DEPTH is 0. The 
command procedure DEPTH is 1 when a command 
procedure is invoked interactively, or 2 within a Batch 
job. A nested command procedure has the DEPTH of 1 
greater than the level from which the command procedure 
was executed. 


Returns current SET ECHO status. Possible values are: 
*“ECHO/’, “NOECHO/WARNINGS’”, and 
“NOECHO/NOWARNING®S”. 


Returns number of free channels available to the user. 


Returns “TRUE” if the current job’s access mode is 
INTERACTIVE, or “FALSE” otherwise. 


Returns currently open log file. 


Table 3-2 (Cont.): Keywords and Return Values for FSENVIRONMENT Function 


Keyword Type Description 

LOGFILE_PROMPT _ string Returns the currently defined log file prompt; identical to 
the reserved symbol $LOGFILE_PROMPT. 

MAX DEPTH integer Returns maximum number of command procedure levels. 

NOCONTROL string Returns "" if SET CONTROLE=C is in effect or at the 
interactive level, or “C” if SET CONTROLE=C is in effect. 

ON_CONTROL_C string Returns “TRUE” if an ON_CONTROL_C command is 


specified, or “FALSE” if at the interactive level or if an 
ON_CONTROL_C command is not specified. 


ON_SEVERITY string Returns severity level of the current ON severity THEN 


command. Possible values are: “NONE”, “ERROR”, 
“WARNING”, “SEVERE ERROR’. 
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PROCEDURE string Returns command procedure currently executing. 

PROMPT string Returns currently defined DCL prompt string; identical 
to the reserved symbol $PROMPT. 

PROTECTION integer Returns default file protection code. 

TIME STAMP string Returns “TRUE” if time stamps are currently enabled for 
batch log files, or “FALSE” otherwise. 

VERIFY string Returns “VERIFY[/DEBUG)’ if SET VERIFY is in effect, 


or “NOVERIFY” if SET NOVERIFY is in effect. 
Table 3-3 lists the valid field keywords for FSPARSE. 


Table 3-3: Field Keywords for FSPARSE Function 


Keyword Meaning 

DEVICE Returns device name string. 

PPN Returns project-programmer number string. 
NAME Returns file name string. 

TYPE Returns file type string. 

STATUS Returns device status word integer. 

FLAGS Returns filespec flag word integer. 
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Chapter 4 


System Utility Programs 


are arranged in alphabetical order. See Appendix A for OPSER and 
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obsolete system utility programs. 


Copies all of the information from one device to another device of the 
same type. You can aiso use COPY to verify that the information on 
two like devices is identical. You cannot specify individual files. 


Privilege Required 


¢ DEVICE privilege if either or both tape drives is a restricted device 


¢ RDNFS privilege for the input disk and WRINFS privilege for the 
output disk 


To Run the Program 
RUN AUXLIBS : COPY 
Format 


new device=old device/switches 


Usage Notes 


You must specify the fast copy switch (/FC) or the no copy switch (/NC) 
in the command string to copy information from one device to another. 
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Switches 


/BL:n 

Specifies block size you can use to speed up copying or to copy magnetic 
tapes written with nonstandard record sizes. To speed up copying, 
specify a larger block size. 

/DE:n 

Specifies a density setting other than the default when accessing mag- 
netic tape. Currently available densities are 800, 1600, 6250, 6667, 
8000, and 10000 bpi. You can also specify MINIMUM and MAXIMUM, 
which causes the system to set the density to the minimum or maxi- 
mum the tape drive supports. 


/FC 


Specifies fast copy. Copies information from one device to another. 


/HE 
Prints an online HELP message for the COPY program. 


/NC 
Specifies no copy. You use /NC in conjunction with /VE to verify that 
the information on two devices is identical. 


/PA:mn 
Specifies a parity setting other than the default when accessing mag- 
netic tape where n can be ODD or EVEN. 


VE . 
Verifies whether the information on a device unit has been copied 
correctly. You must specify either /FC or /NC with this switch. 


DIRECT 
DIRECT lists information about files from a disk or tape directory. 


Privilege Required 


¢ Create/Rename access to any output file you specify 


¢ Read access to any file you display from accounts other than your 
own 


To Run the Program 


RUN SDIRECT 
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Format 


#{output=linput/switches, input/switches.,... 


Usage Notes 

Output is optional and can be a device specification or a disk file 
specification. If you do not specify output, omit the equal sign (=). 
By default, DIRECT displays output on your terminal. Input can be 
any number of disk file specifications. The disk file specification on 


input can include a device, file name, file type and project/programmer 
number (PPN). 


If you do not specify a device, DIRECT uses the public disk structure 
and denotes it by the SY: specification. 

You can substitute the asterisk (*) character and the question mark (7) 
character wildcards in the file name and file type fields. In addition, 
you can substitute the * character in the PPN field. 

You can substitute the * character for the entire file name, the en- 
tire file type, both the file name and file type, and the entire file 
specification. 


Switches 


/AL 
Lists the file name, type, and number of blocks of each file. 


/AT 
ISA 
Lists the file name, type, symbolic file attributes, and caching status. 


/BK 
Lists the directory for the specified device in reverse order. 


/BR 
/F 


Lists the file name, type, and a brief summary message. 


/CL 
Lists the file name, type, and cluster size. 


{DA 
Lists the file name, type, and date of creation. 
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/DI 

/LI 

Lists most important data to include heading, file name, type, size, 
protection code, creation date, and an ending summary message. 


Lists all relevant data to include heading, file name, type, size, protec- 
tion code, date of last access, date of creation, time of creation, cluster 
size, associated run-time system, file position, symbolic attributes, open 
status (if possible to display on the same line), files marked for deletion 
(see /MD), and an ending summary message. 


/EX or /TY 
Lists file name and type. 


/FU 

Lists heading, file name, type, size, protection code, date of last access, 
date of creation, time of creation, cluster size, associated run-time 
system, file position, open status, and an ending summary message. 


/HD 

Displays heading at top of columns in the listing for those listings that 
normally do not include a heading. If you specify /HD without another 
switch, DIRECT displays an error message. 


/HE 
Displays the file DIRECT.HLP, which describes the DIRECT program. 


/LA 


Lists the file name, type, and date of last access or update, depending 
on disk initialization. 


/MD 

Lists all files, and flags those files marked for deletion by appending an 
* character after the file name. Tentative files are marked for deletion 
until closed. 


/N 
Lists only those entries that do not match the specified input file 
specification. 
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INA 


Lists file name only. 


/OA 
Lists file names, types, and a series of octal numbers that represent file 
attributes. 


/OP 


Lists file name, type, open status, and access count. 


/PO 

Lists file names, types, and the position of the files on disk (the device 
eluster number of the file’s first block). 

/PR 

Lists file name, type, and file protection code. 


/RT 
Lists the name of the run-time system that created the file. 


/SI 
(SZ 
Lists file name, type, size (in blocks) of each file. 


/SU 
Lists summary data only to include number of designated files and 
total number of blocks occupied by designated files. 


/TI 
Lists file name, type, and the date and time each file was created. 


/W 


Lists data across the width of a line rather than one item per line. 


File Attributes 


File attributes are system attributes or file description data that RMS- 
11 software requires. For instance, both COBOL and BASIC-PLUS-2 
use RMS-11. The User File Directory (UFD) for a given file contains 
the file attributes for that file. You can list file attributes symbolically, 
using the /SA, /AT, and /S switches and octally, using the /OA switch. 
The symbolic file description attribute fields are: 

BK 

Displays if the file organization is relative or indexed; indicates the 
bucket size in block. 


System Utility Programs 4-5 


CC 
Displays the type of carriage control as IMP (implied) or FOR 
(FORTRAN). 


EX 
If you do not use the default, indicates the number of blocks added to 
the file each time you increase its size. 


FO : 
Displays type of file organization as SEQ (sequential), REL (relative), 
and IDX (indexed). 


HS 
If you do not use the default, indicates the fixed header size. 


NOSPAN 
If displayed, indicates that records are not allowed to span block 
boundaries. 


RECSI 
Displays the size, in bytes, of the largest file record. 


RF 

Displays the maximum record length of the file. The possible formats 
are UDF (undefined), FIX (fixed), VAR (variable), VFC (variable /fixed 
control), and STM (stream). 


USED 
Displays the number of blocks currently in use, followed by the number 
of bytes used in the last block. 


The symbolic system attribute fields are: 

CACHE 

Indicates that the file is cached. 

SEQ 

Indicates that caching is done using sequential mode. 
RND 


Indicates that caching is done using random mode. 


NOBACKUP 
Indicates that the file data is not backed up; only the file attributes are 
backed up. 
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FILCOM 


IGNORE 
Indicates that the file is completely ignored by BACKUP. 


FILCOM (File Compare) lets you compare two ASCII files, line by line, 
and identifies differences. When you run the program, specify the files 
you want to compare and any switches that direct that comparison. 


Privilege Required 
e Read access to the files you want to compare 


¢ Create/Rename access for any output file you create 


To Run the Program 


RUN $FILCOM 


Usage Notes 


After FILCOM prompts "OUTPUT TO <KB:>?", type one of the three 
responses: 


¢ The device designator or file specification to which FILCOM writes 
the comparison data. Your terminal is the default. 


If you respond with a device designator or a RETURN key, FILCOM 
displays a series of additional prompts. These prompts request: 
— The files you want to compare. 

When you specify the files to be compared, include the file type. 


You can use the wildcard specifications asterisk (*) and question 
mark (?) to designate the input files. 

— The number of successive lines in the files that constitute a 
match. 


As FILCOM compares lines in a file, it prints the differences 
until it finds a series of lines that are identical. The number of 
lines that constitute a series are determined by your answer to 
this prompt. The default is three lines. 


— Whether FILCOM should consider BASIC-PLUS continuation 
lines as part of a numbered line. 


By default, FILCOM treats continuation lines as new lines. 
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— Whether FILCOM should compare blank lines. 


You can also specify one or more switches in response to 
FILCOM’s initial prompt. These switches override the prompts 
and provide an alternative way to set comparison parameters. 


e A single command line that contains all the information FILCOM 
needs to make the file comparison: 


OUTPUT TO <KB:>? output=input1,input2,/switches 

Output can be: 

— Acomplete RSTS/E file specification. 

— Awildcard specification (description in "Wildcards" section). 


— No specification. If you specify only input, FILCOM displays 
output at your terminal. 


The equal sign (=) is required only if you specify output. An 
equal sign with no output specification causes FILCOM to 
output the result of its comparison to a file on the public 
structure. FILCOM creates this file in the current account with 
a file name taken from the first input file and a .DIF file type. 


The input files represent the two files you want FILCOM to 
compare. You can describe these files with full file specifica- 
tions, file names and types, or wildcards. 


If you specify the full command line, FILCOM does not display 
any other prompt and begins the file comparison. Using the 
command lets you specify wildcards (*) and (?) in the file 
specifications and one or more switches. 


¢ A command line that contains an indirect file name. The indirect 
command file is an ASCII text file you can create with PIP or an 
editor. The file must contain all of the information FILCOM needs 
to make the file comparison: 


output to <kb:> ? @filename 


In the previous command line above, the file name is an indirect 
command file. The indirect command file can contain a single line 
command, or it can contain multiple line answers to the FILCOM 
prompts. If the command file contains answers to the FILCOM 
prompts, each prompt must be answered in the four step sequence. 
You cannot nest indirect command files. FILCOM processes an at 
sign (@) in the command file as an assignable account specification. 
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Wildcards 


You can specify FILCOM input files as full RSTS/E file specifications 
or as wildcard characters. When you use wildcards, FILCOM bases its 
search for files on the first input file specification. FILCOM output files 


can contain a wildcard for either the file name or type. You cannot use 
wildcards in both fields. 


With wildcards, you can cause FILCOM to make multiple file compar- 
isons based on a single command line specification. When you use this 
method, FILCOM displays the differences found in each set of files in 
the standard manner. After it finishes comparing the files, FILCOM 
displays a summary of the format: 


X DIFFERENCES FOUND IN Y FILES OF Z TOTAL FILES 
COMPARED 


Where X is the number of differences in all files, Y is the number of 
files that contain differences and Z is the number of files compared. 


Switches 


/AP 

Directs FILCOM to open the output file for APPEND. If you omit 

this switch, FILCOM deletes any existing output file of the same name 
before writing differences. With the /AP switch, you can direct FILCOM 
to write differences into an existing output file. 


/[NOJBA 
Specifies whether FILCOM considers BASIC-PLUS continuation lines 
as part of a numbered program line. The default is /NOBA. 


/AINOJBL 
Specifies whether FILCOM considers blank lines in its comparison. 
The default is /NOBL. 


/COL:m:n] 

Converts tabs to the appropriate number of spaces and directs FILCOM 
to compare characters starting in column position m and continuing for 
n characters. If you include the ‘COMPARE switch but do not specify m 
or n, FILCOM defaults m to column position 1 and n to 72 characters. 


/LI[:n] 

Specifies the maximum number of lines that are allowed to differ before 
FILCOM stops examining the file. If you include the /LIMIT switch but 
do not specify a limit in n, the default is 60 differing lines. 
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/MA{:n] 
Specifies the number of lines in the file that constitute a match. The 
default is three. 


/SU 
Directs FILCOM to list the total number of differences found in the 
files without listing individual lines. 


FIT 


FIT (File Transfer) performs file transfers between devices. With FIT 
you can: 


Transfer files between RSTS/E-structured devices and RT11- 
structured devices. 


Transfer files from a DOS disk to a RSTS/E device. 


List the directory of a RSTS/E-, RT11- or DOS-structured device, 
including RX01 and RX02 flexible diskettes. 


Delete files on an RT11-structured device. 
Initialize (zero) an RT11-structured device. 
Compress (squeeze) the files on an RT11-structured device. 


Privilege Required 


Read access to input files and files included in a directory listing 
Create/Rename access to any output files you create 
Write access to any files you delete 


DEVICE privilege for restricted tape drives and restricted 
RX01/RX02 disk drives 


RDNFS privilege for input disk devices that are not RSTS/E devices 


WRITNES privilege for output disk devices that are not RSTS/E 
devices 


SYSIO privilege to set the protection/privilege bit when transferring 
files to a RSTS/E system 


To Run the Program 


RUN AUXLIBS: FIT 
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Transferring Files 
In response to the FIT> prompt, specify the files in the format: 


output[/switch]=]input[/switch] 


Listing a Directory 
In response to the FIT> prompt, specify the directory in the format: 
dev:[proj, prog |filename.type/L[I][/sw] 


Deleting Files on RT11-Structured Devices 
In response to the FIT> prompt, specify files in the format: 
dev:filename.type/DE[/switch] 


Initializing RT11-Structured Devices 

In response to the FIT> prompt, specify the device in the format: 
dev:/ZE:m/[/switch] 

Compressing RT11-Structured Devices 


In response to the FIT> prompt, specify the device in the format: 
dev:/SQ[/sw] 


Switches 


/D 
Deletes a file on an RT11 device. 


/DOS 
Specifies a file on a DOS format disk. 


/HE 
Prints HELP text for FIT. 


/DI, /LI 

Lists the directory of the device. 

/N:n 

Use with /ZE to create n directory segments on the initialized device. 
Each segment consists of two 512-byte blocks. The value n (range 1-31) 
determines the size of the directory on the device; and, therefore, the 
number of files stored on the device. 
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/RSTS 
Specifies a file on a RSTS/E disk or device. 


/RT11 
Specifies a file on an RT11-structured device or specifies an RT11- 
structured device. 


/SQ 


Compresses (squeezes) an RT11-structured device. 


/W 
Lists all file transfers and deletions on your terminal. 


/ZE[:m] 
Initializes (zeros) an RT11-structured device. 


GRIPE 


GRIPE lets you send messages to your system manager. The comments 
you type are written to a common file kept by your system manager. 


Privilege Required 
You do not need any special privilege to run the GRIPE program and 


send a message to the system manager. However, you need WACNT 
privilege to use the *LIST and *RESET commands. 

To Run the Program 

RUN AUXLIBS: GRIPE 

Commands 


*LIST 
Allows you to display the contents of the GRIPE.TXT file on your 
terminal, print it on a line printer, or write it to a file. 


*RESET 
Deletes the GRIPE.TXT file. 


HELP 


HELP displays information about system programs and system com- 
mands. 
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Privilege Required 


e Create/rename access to any file you create using the /OUTPUT 
switch 


To Run the Program 
RUN HELPS: HELP 
Usage Notes 


HELP prints an identifying header line and prompts for a topic. In 

response to the Topic? prompt, type one of the following: 

¢ The name of the topic about which you want information. If you 
abbreviate the name, HELP displays information on al! topics that 
match the abbreviation. In addition to the topic you can specify one 
or more subtopics (separated by spaces) associated with that topic. 
The level to which you can nest subtopics depends on the particular 
topic about which you want information. 

¢ A * wildcard character, which directs HELP to display information 
on all available topics. 

e The? character, which directs HELP to display a list of available 
topics. 


To exit from the HELP program, enter CTRL/Z at any prompt. You can 
also exit HELP by pressing RETURN at the Topic? prompt. 


Switches 


/OUTPUT 

Use only with the HELP CCL command. By default, HELP displays 
the information you request at your terminal. /OUTPUT overrides the 
default and writes the requested information to a file. For example: 


HELP/OUTPUT:filespec topic [subtopic [...]] 
or 
HELP/OUTPUT-filespec * [...] 


/PROMPT 

Use only with the HELP CCL command. When you specify /PROMPT 
with a topic, HELP displays the information you request, and HELP 
then displays the Topic? prompt. When you specify /PROMPT with no 
topic, HELP displays only the Topic? prompt. 
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ODT 


The ODT program opens a file, a peripheral device, or memory as an 
address space and allows you to examine and change word or byte 
locations within that address space. You can also list the contents of 
certain table locations in the operating system. 


Privilege Required 

¢ RDMEM privilege to read memory 

¢ RDMEM and SYSMOD privileges to read and change memory 
¢ RDWFES privilege to read a non-file-structured device 

¢ WRITWES privilege to write to a non-file-structured device 

* Read access to read a file 

¢ Read and write access to read and change a file 


ODT Characters and Symbols 


You access and manipulate memory locations and data by typing 
characters and symbols that ODT recognizes. The special characters 
and symbols are listed in Table 4—1. 


Table 4-1: ODT Characters and Symbols 


Character 

Symbols Meaning 

/ Opens the previously open location as a word, or opens the 

k/ location designated by k as a word. 

: Opens the previously open location as a byte, or opens the 

k’ location designated by k as a byte. 

: Gives the ASCII representation of the currently open or last 

k" open location, or of the location specified by k. 

% Gives the ASCII representation of the Radix-50 value in the 

k% currently open or last open location, or in the location specified 
by k. 

Closes the currently open location, or modifies the contents of 

k followed by the currently open location with the value k and 

closes it. 
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Table 4—1 (Cont.): ODT Characters and Symbols 


Character 


Symbols 


k@ 


Meaning 


Closes the currently open location and opens the next sequen- 
tial location, or modifies the contents of the currently open 
location with the value of k before closing it and opening the 
next sequential location. 


Closes the currently open location and opens the preceding 
sequential location. 


Takes the contents of the currently open location as a program 
counter relative offset and calculates the next location to 

be opened; closes the currently open location and opens the 
location thus evaluated. 


Takes the contents of the currently open location as an absolute 
address, closes the currently open location; opens and prints 
the contents of the location thus evaluated. If k precedes @, 
the value k replaces the contents of the currently open location 
before it is closed. 


Takes the low order byte of the currently open location as a 
relative branch offset and calculates the address of the next 
location to be opened. Closes the currently open location and 
opens and prints the contents of the relative branch location 
thus evaluated. If k precedes >, the value k replaces the 
contents of the currently open location before it is closed. 


Closes the currently open location and opens the last location 
explicitly open. Returns ODT to the origin of a sequence 

of relative locations determined by _, @, and > character 
operations. 


Separates a relocation register number from an octal value. 
ODT adds the contents of the specified relocation register to 
the octal value following the comma, and forms a relocatable 
address. 


Separates multiple values in a list request using the L charac- 
ter and in a register operation using the R character. 


Specifies the last explicitly open location similar to that used 
by the < character. 
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Table 4—1 (Cont.): ODT Characters and Symbols 


Character 


Symbols 


+ 
space bar 


R 


k1;k2L 
1;k1;k2L 


2;k1;k2L 


Meaning 
Adds the preceding value and following value and uses the 
result. 


Subtracts the following value from the preceding value and 
uses the result. 


Resets all relocation registers to -1 (177777). 
Resets relocation register n to -1 (177777). 
Sets relocation register n to the value k. 


Sets relocation calculation for list requests using the L charac- 
ter. 


Disables relocation calculation set by the F character. 


Prints out monitor table symbolic names and memory ad- 
dresses. 


Prints out the processor status word. 
Uses the last quantity printed by ODT. 
Prints the contents of locations k1 through k2 at the terminal. 


Prints the contents of location k1 through k2 on line printer 
unit 0. 

Prints the contents of location k1 through k2 on another device. 
ODT asks for a device designator by printing the DEVICE 
question. 


To Run the Program 


RUN AUXLIBS$: ODT 


After you type the command line and press RETURN, ODT displays 
the FILE<MEMORY>? prompt. Your response to this question deter- 
mines the way ODT runs and what address space ODT accesses. The 
responses you can type are listed in Table 4—2. 
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PIP 


Table 4-2: ODT Question Responses 


Response 


Press RETURN only. 


Type a file specification, then 
press RETURN. 


Press LINE FEED only. 


Type the file specification, then 
press LINE FEED. 


Meaning 


Allows Read access to memory only if you 
have RDMEM privilege. 

Allows Read access to the file on the device 
specified. If you specify no device, ODT 
uses the system disk. 


Allows Read and Write access to memory 
only if you have RDMEM and SYSMOD 
privileges. 


Allows Read and Write access to the file 
specified. 


TAO AS 


PIP (Peripherai Interchange Program) copies files from one RSTS/E 
device to another, concatenates, deletes, and renames files, changes 
protection codes and file attribute data, initializes accounts, and lists 


directories. 


Privilege Required 


¢ Read access to any input files you read 


e Create/Rename access to any output files you create 


¢ Write access to any output files you write to 


¢ Create/Rename access to any input files you rename 
¢ TUNE privilege if you use the /LOCK and /PRIOR switches 
¢ DEVICE privilege for any restricted devices you access 


To Run the Program 
RUN S$PIP 


Format 


[output[/sw]=linput[/sw][,input/[/sw]....] 
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Usage Notes 


Specify input and output file specifications in the standard format. 
Note that both input and output file specifications can contain the 
file specification switches /PROTECT, /FILESIZE, /CLUSTERSIZE, 
/MODE, /RONLY, and /POSITION. 


PIP lets you specify a PIP indirect command file in response to its 
prompt. You must type the at sign (@) as the first character following 
the prompt. If you do not include the file type, the default is .CMD. 
Nesting is permitted. The number of files you can nest depends on the 
amount of memory available. If a line in the indirect command file 
begins with a semicolon (;), PIP interprets the line as a comment and 
skips to the next line in the file. 


PIP allows you to use the asterisk (*) and question mark (?) wildcard 
characters in input and output file specifications. 


Informational Switch 


/HELP 
Prints a text message at your terminal that describes file specifications, 
switches, and options. 


File Transfer Switches 


/ACCESS 

For disk input only, changes the file’s last access date to the current 
date. If you do not specify this switch, PIP preserves the last access 
date. 


/APPEND 

/EXTEND 

For disk output only, appends the input file to the output file (ex- 
tends the output file). If no output file exists, PIP displays a warning 
message and creates the file. 


/ASCII 
Formatted ASCII transfer; PIP discards NULL characters, parity bits, 
and rub-out characters. 


/BLOCK 
Performs a block-by-block transfer with no data translation. 
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/BSIZE 

For magnetic tape output only. PIP uses the physical block size speci- 
fied by n (Gin bytes) for data written to the tape. 

/CLUSTERSIZE:n 

For disk only, sets the output file cluster size to n. You must place 
this switch adjacent to the output file specification. To use the RSTS/E 
automatic clustersize optimization feature, specify /CLUSTERSIZE:0. 
The specified cluster size cannot be less than the pack cluster size. 


/AIGNORE 

/GO 

Ignores ?Data error on device errors. 

/MODE:n 

Sets the mode n in which PIP opens the file. You must place this switch 
adjacent to the file specification. 


/NEW 
For disk output only, creates a new file with the current date of creation 
and access. 


/NOATTRIBUTE 

Transfers the file without writing attributes to the output file. No 
file or record conversion takes place (see /RMS for record conversion 
options). 


/RETAIN 
For disk output only, retains creation and access date of the input file. 


/RTS:name 

Sets the output file’s run-time system name to that specified in name. 
If you omit the output file specification, PIP renames the input file’s 
run-time system. 


/NOSUPERSEDE 

/NOS:NOWARN 

/NOS:QUERY 

/NOS:INSPECT 

Displays an error message and ignores the operation if an output file 
already exists. If you include the :‘NOWARN option, PIP does not 
display the error message. The :QUERY and :INSPECT options are 
synonymous. They cause PIP to display the prompt "OK to replace 
file filespec?" if the output file already exists. Type Y, YE, or YES to 
replace the file. 
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/PROTECT 

/PR:NOWARN 

/PR:QUERY 

/PR:INSPECT 

Same as NOSUPERSEDE. DIGITAL recommends NOSUPERSEDE to 
avoid conflict with protection code option. 


/UPDATE 
Opens a pre-existing disk file and overwrites the existing data. If no 
file exists, PIP creates a new one. 


Files with Attributes, Translation Switches 


/RMS 

For input disk files, translates RMS format to formatted ASCII or 
formatted binary. For output disk files, PIP translates formatted ASCII 
or formatted binary to RMS variable length records. For nondisk 
transfers, PIP’s translation depends on current format. If you do not 
specify the /RMS switch for disk files, PIP performs no translation. 
You cannot apply the switch to both input and output files in the same 
command line. 


/RMS:FA 
For input or output files, specifies formatted ASCII in the translation. 


/RMS:FB 

For input or output files, specifies formatted binary in the translation. 
/RMS:FTN 

For input files, translates FORTRAN carriage control to formatted 
ASCII. For nondisk output files, translation is automatic. 

/RMS:IM 

For input files only, performs the same as /RMS but does not transfer 


attributes. However, PIP does remove RMS variable length header 
information. 


/RMS:PRN 
For input disk files, translates RMS print files to formatted ASCII. 


4-20 System Utility Programs 


Date Switches 


/AFTER:dd-mmm-yy 
Includes only files that were created after, but not on, the given date. 


/BEFORE:dd-mmm-yy 
Includes only files that were created before, but not on, the given date. 


/CREATION 
Uses the date of creation in file operations. 


/DLA 

For disk only, uses the date of last access in file operations. 
/ON:dd-mmm-yy 

Includes only files that were created on the given date. 
/SINCE:dd-mmm-yy 

Includes only files that were created on or after the given date. 
/TODAY 

Includes only files that were created on the current date. 


/UNTIL:dd-mmm-yy 
Includes only files that were created on or before the given date. 


Size Switches 

/EQ:n 

Includes only files with size equal to n. 

/GE:n 

Includes only files with size greater than or equal to n. 

/LE:n 

Includes only files with size less than or equal to n. 

You can combine the /LE and /GE switches to select files between 
a minimum and maximum size (inclusive). If you use any of these 


switches together with the directory switch argument :AL, files are 
selected based on allocated size. 


System Utility Programs 4~-21 


File Operation Switches - General 


/HALT 
Halts a magnetic tape wildcard search as soon as it detects a file that 
does not match. 


INSPECT 

/QUERY 

Displays the file specifications (one at a time) that match a wildcard 
specification. If used in transfer or /DELETE operations, as each file 
specification is displayed, type Y (for Yes) to transfer or delete; type 
any other character to omit. Enter CTRL/Z to end the display and 
operation. 


/AIN:SLOW 
Prints file name, type, file size, protection code, creation date, and last 
access date. 


/LOG 

/WATCH 

Displays a report on all actions taken during execution. PIP prints the 
report at your terminal. 


/NOLOG 


Displays nothing for actions taken during execution. 


/NOREWIND 
/RW:NO 
Does not rewind the magnetic tape before an input file search. 


/VERSION 
ADENTIFY 
Displays the program’s current version number. 


File Operation Switches - Deletion 


/DELETE 
For disk and DECtape only, deletes the specified file. 


/DELETE:NO 
Does not display an error message if the file to be deleted does not 
exist. 
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/ERASE 

/WIPEOUT 

iW 

For disk, overwrites the file with zeros before deletion. These switches 
are the same; you must use one of them in conjunction with the 


/DELETE switch. 


File Operation Switch - Rename 


/RENAME:option 
For disk and DECtape only, renames the input file to that of the output 
file. 


/RENAME:NO 
Does not display an error message if you try to rename a file to the 
name of a file that already exists. The file is not renamed. 


File Operation Switches - Zeroing 


/ZERO 
Zeros (initializes) the directory of an account or device or initializes the 
labels on a magnetic tape. 


/ZERO/DENSITY:n 
For magnetic tape only, sets the tape density before the zero operation. 


/ZERO/PARITY:ODD 

/ZERO/PARITY:EVEN 

For magnetic tape only, sets the parity of the tape before the zero 
operation. 


Privileged-Only Switches 


/LOCK 
The system locks PIP in memory for the duration of the current opera- 
tion. Note that you cannot abbreviate /LOCK. 


/PRIORITY 
The system runs PIP at special priority for the duration of the current 
operation. Note that you cannot abbreviate /PRIOR. 
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File Operation Switches - Listing 


/BRIEF 
/FAST 
Displays a brief directory listing. 


/DIRECTORY 

/LIST 

/SLOW 

Displays a full directory listing. The listing switches accept option 
specifications that modify the directory listing. 

/MDELETE 

Includes files that are marked for deletion in the directory listing. 


PIP Directory Listing Options 

:AL 

Lists file name, type, and the number of blocks allocated to the file. 
:CL 

Lists file name, type, and file cluster size. 

‘DA 

Lists file name, type, and file creation date. 

:DI 

Lists file name, type, size, protection code, creation date, and column 
headers. 

:EX 

Lists file name and type same as :TY (provided for compatibility with 
previous versions of RSTS/E). 


:-FU 

Lists heading, file name, type, size, protection code, date of last access, 
date of creation, time of creation, cluster size, associated run-time 
system, file position, open status, and summary. 


:HD 

Includes column headers in the listing. 

:LA 

Lists file name, type, and date of last access or date of last write 
(depending on disk initialization). 
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‘NA 

Lists file name. 

:0A 

Lists file name, type, and octal representation of file attributes. 
:PR 

Lists file name, type, and protection code. 

‘RT 

Lists file name, type, and associated run-time system. 

S 

Lists all information. 

‘SA 

-AT 

Lists file name, type, symbolic file attributes, caching status, and 
backup status. 

Caching is indicated by one of the following entries: 


¢ CACHE:ON:RAN; file is automatically cached randomly when open. 


¢ CACHE:ON:SEQ; file is automatically cached sequentially when 
open. 


¢ CACHE:OFF:SEQ; file is not automatically cached, but if cached, it 
is cached sequentially. 


Backup status is indicated by one of the following entries: 

¢ NOBACKUP - the file data is not backed up; only the file attributes 
are backed up. 

¢ IGNORE - the file is completely ignored for BACKUP purposes. 


SZ. 

Lists file name, type, and file size. 

‘SU 

Lists only summary data to include number of designated files and 
total number of blocks occupied by designated files. 

:‘TI 

Lists file name, type, and date and time of creation. 
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‘TY 
Lists file name and type. 


:W 
Lists file name and type across the width of the page or screen. 


:WI 
Lists file name only across the width of the page or screen. 
NOTE 


The :OA, :SA, :AT, and :S options cause PIP to display file 
attributes in octal or symbolic representation. 


PMDUMP 


PMDUMP formats the contents of a postmortem dump into readable 
form and lets you copy it to a file on any RSTS/E device. 


Privilege Required 
¢ Read access to the input file 


¢ Create/Rename access to the output file 


To Run the Program 
RUN AUXLIBS : PMDUMP 
Format 
outfil.typ=infil.typ 


Usage Notes 
Input and output file specifications are in the standard format. 


If you press RETURN or LINE FEED in response to the prompt 
PMDUMP applies the following defaults: 


, 


Device SY: 

account The current account 

file name The input file name 

type .PMD for input, .LST for output 
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SYSTAT 


For PMDUMP to be successful in formatting the dump: 


The run-time system that controls your job must be RSX or RSX- 
based. 


The task to be dumped must have already aborted. 


You must request a postmortem dump with the /PM switch when 
you link the program with the Task Builder. The /PM switch causes 
the Task Builder to set an indicator in your executable program file. 
This means that, if your program terminates abnormally when it is 
executed, the system automatically writes the memory contents to 
a disk file. 


SYSTAT displays current system information about jobs, devices, 
disks, buffer status, run-time systems, resident libraries, and message 
receivers. 


Privilege Required 


WREAD privilege to use the /O and /W switches to obtain informa- 
tion about open files 


SYSIO privilege to obtain status of temporary privileges for jobs 


TUNE privilege to obtain maximum size, priority, and run burst 
information about jobs 


To Run the Program 


RUN SSYSTAT 


Usage Notes 


At this point you can specify any RSTS/E device or a file specification 
for the status report output. Possible replies are: 
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Output 


Response Meaning 

Displays report on your terminal. This is equivalent to KB: 
response. 

LP: Sends the report to the system line printer if only one line 


printer is on the system, or to line printer 0 if multiple line 
printers are on the system. 


LPn: Sends the report to line printer n if that printer is not 
currently in use. 

KB: Displays the report on your terminal. This is equivalent to 
pressing RETURN. 

KBn: Displays the report on terminal n in the system if that 


terminal is on line and not currently in use. 


dev:filename.type Writes the report to the file specified. The default device is 
the system device. No file type is appended unless specified. 


? Writes the report to a file on the public structure, and 
displays the file name on your terminal. SYSTAT names 
the file according to the current date and time of day; its 
type is .RPT. 


NOTE 


You can specify switches separately or in any combination. If 
you specify more than one switch, only one slash is required. 


Switches 


/A 
Reports status of attached jobs only. 


/B 
Reports status of busy devices only. 


/C 


Reports memory allocation on system. 


/D 
Reports status of disk structure only. 


/F 
Reports status of free buffers only. 
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/Kn 


Displays report on terminal n in the system. 


/L 
Reports status of resident libraries only. 


/M 
Reports status of message receivers only. 


/n 
Reports status of job n only. 


/nym 
Reports status of account [n,m] only. 


/n,* 
Reports status of jobs having project number n only. 


*n 
Reports status of jobs having programmer number n only 


NULL 

Reports complete system status to include jobs, run-time systems, res- 
ident libraries, busy devices, disk structure, free buffers, and message 
receivers. 


/0 

/O[:dev:] 

/O[;job] 

/O[:dev:job] 

Reports all nonsystem files that are open, on a specific device "dev:", by 
a specific job "job". 

[W 

/WI:dev:] 

/W[;job] 

/WI:dev:job] 

Reports all nonsystem files that are open, on a specific device "dev:", 
by a specific job "job", along with the jobs accessing them, the block 
number being accessed, the blocks currently locked, and the use of 
special extend mode. 


/R 
Reports status of run-time system only. 
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/S 
Reports status of jobs only. 


/U 


Reports status of detached jobs only. 


/0,0 


Reports status of jobs not logged into the system only. 


Several of the DCL SHOW commands perform the same functions as 
many of the SYSTAT switches. The following list is a cross reference 
between the DCL SHOW commands and the equivalent SYSTAT 


switches: 


DCL Command 

SHOW BUFFERS 

SHOW DEVICE/ALLOCATED 
SHOW DISKS 

SHOW FILES/OPEN 
SHOW JOB 

SHOW LIBRARY 

SHOW MEMORY 

SHOW RECEIVERS 

SHOW RUNTIME_SYSTEM 
SHOW USER 
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SYSTAT Switches 
/F 

/B 

/D 

/0, (W 

/A, /S, /U0 


/A, /S, /U 


The abbreviations listed in Table 4-3 appear in the full status report. 


Table 4-3: Abbreviations for Full SYSTAT Report 


Abbreviation 


CR 


DB, DF, DK, DL, 
DM, DR, or DU 


DET 
DT 
DX 
FP 


HB 


KB 


LP 
MM, MS, MT, or MU 


» 


Meaning 
Job Status (State) 


Job’s state cannot be determined. 
Job is not logged into the system. 


Job is in Ctrl/C state, awaiting input from the key- 
board monitor. 


Job is waiting for buffers (no space is available for I/O 
buffers). 


Job is waiting for card reader input. 
Job is waiting to perform disk I/O. 


Job is detached from all terminals. 
Job is waiting for DECtape I/O. 
Job is waiting for flexible diskette I/O. 


Job is waiting for file processing action by the system 

(opening or closing a file, file search). 

Job is detached and waiting to perform I/O to or from 

a terminal. 

Job is waiting for input from a terminal. 

KBn* Job is waiting for input from a dialup 
terminal. 


KBn! Job is waiting for input from a LAT termi- 
nal. 


KBn*! Job is waiting for input from a terminal 
dialed up into a LAT server. 


KBnJm Pseudo keyboard is being controlled by Job 
n, such as a batch job or a job that is set 
host to the system. 


Job is waiting to perform line printer output. 


Job is waiting for magnetic tape I/O. 
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Table 4-3 (Cont.): Abbreviations for Full SYSTAT Report 


Abbreviation 


PP 


Meaning 

Job Status (State) 
Job is waiting to perform output on the high-speed 
paper tape punch. 


Job is waiting for input from the high-speed paper tape 
reader. 


Job is waiting for RJ2780 I/O. 

Job is running or waiting to run. 

Job is waiting for residency. 

Job is sleeping (SLEEP statement). 

Job is sleeping and is a message receiver. 


Job is waiting to perform output to a terminal. 


The following status descriptions may appear after one or more of the 
other job state abbreviations: 


Lek 


Nsw 


Swi 
Swo 
Xnn 
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Job is locked in memory for the current operation. 


Job has requested that it not be swapped from memory 
and cannot be swapped unless it requests additional 
memory. 


Job is currently being swapped into memory. 
Job is currently being swapped out of memory. 


Job is swapped out and occupies slot nn in swap file 
X; file is denoted by A,B,C, or D to represent files 0 
through 3 of the swapping structure. 


Busy Devices (Why) 


Magnetic tape is assigned with ANSI standard labeling 
format. 


Device is explicitly assigned to a job. 
Magnetic tape is assigned with DOS labeling format. 


Device is open on a channel. 


Table 4-3 (Cont.): 


Abbreviation 


Dirty 
DLW 


DP 
Job n 
Lek 
LDX 
NFF 
NFS 
PRI 
PUB 
R-O 


Abbreviations for Full SYSTAT Report 


Meaning 
Disk Structure (Comments) 


Disk needs cleaning. 


Date of last write (modify), rather than date of last 
access, is stored in file accounting entries. 


A "DB" or "DR" disk that is dual ported. 

Private disk is assigned to job n. 

Disk is in a locked state. 

Disk’s SAT is loaded. 

New files on this disk are put at beginning of directory. 
Disk is open as non-file-structured device. 

Cartridge or pack is private. 

Cartridge or pack is public. 

Disk unit is read-only (write-locked). 


System Utility Programs 4~33 


Table 4-3 (Cont.): Abbreviations for Full SYSTAT Report 


Abbreviation 


Meaning 


Run-time Systems and Resident Libraries (Comments) 


Addr:xxx 
CSZ 


DF KBM 
EMT yyy 
KBM 
Loading 


Monitor 
NER 


Non-Res 


Perm 


Primary 


Rem 
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Denotes the starting address of the run-time system or 
library. 


Proper job image size (in K words) to run a program 
can be computed as K-size=(filesize+3)/4. 


Run-time system is the default keyboard monitor. 
Denotes the EMT code for special EMT prefix. 
Run-time system can serve as keyboard monitor. 


Run-time system or library is being loaded into mem- 
ory. 
Denotes monitor RSX emulation. 


Errors occurring within run-time system or library will 
not be sent to system error log. 


Run-time system or library is nonresident. 


Run-time system or library will stay in memory when 
not being used. 


Denotes the primary run-time system. 


Run-time system or library will be removed from 
memory as soon as all its jobs switch to another 
run-time system or library. 


Run-time system or library allows read/write access. 


Run-time system or library will be removed from 
memory when not being used. 


Run-time system or library can serve only 1 user. 


Table 4-3 (Cont.): Abbreviations for Full SYSTAT Report 
Abbreviation Meaning 


Message Receivers (Access) 


Evt Indicates the DECnet event logger. 

Lel Local senders are allowed for this receiver ID. 

Net Network senders are allowed for this receiver ID. 

One User has indicated that job should handle only one 
network link. 

Prv Local senders must be privileged to send to this re- 
ceiver ID. 

The abbreviations listed in Table 4—4 appear in the open file reports. 

Table 4-4: Abbreviations for Open File Reports 

Abbreviation Meaning 

Open Files (Status) 

Ctg File is contiguous. 

MDL File is marked for deletion. 

NoK File cannot be renamed or deleted. 

None No files are open on the disk. 

Pla File is placed. 

System files only Only swap files or run-time systems are open on the 
disk. 

Tent Tentative file. 

UFD File is a UFD-type entry. 

Upd File is open in UPDATE mode. 
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Table 4—4 (Cont.): Abbreviations for Open File Reports 
Abbreviation Meaning 


Jobs Accessing Open Files (Access) 


Aex File is open in mode 8. 

Ca File is open for user data caching. 

Lock File has an implicit lock. 

Lock n+m File has an explicit lock starting at block n plus m 
blocks in length. 

NFS File is non-file-structured. 

Rd User has read access to the file. 

Rnd File is open for random user data caching. 

RR File is open read regardless. 

SpUp File is open in special UPDATE mode. 

Seq File is open for sequential user data caching. 

Tent Tentative file. 

UFD File is a UFD-type entry. 

Up File is open for UPDATE. 

Wr User has write access to the file. 


TALK 


The TALK program allows you to communicate with other terminals 
on your system. You can send a message to a user’s terminal or to the 
system console. 


Privilege Required 


Usually your system manager assigns a protection code of <232>, 
which permits all users to run TALK. However, your system manager 
can restrict the use of TALK by assigning a protection code of <124>. 
Check with your system manager to find out if you have access to 
TALK. 


To Run the Program 


RUN AUXLIBS : TALK 
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Usage Notes 


After TALK displays the To which keyboard? prompt, type the number 
of the keyboard to which you want to send a message. 


After you enter a keyboard number and press RETURN, TALK displays 
the following instructions: 


Enter message below (CTRL/Z to end): 
Message: 


Enter as many message lines as you want. 
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Chapter 5 
Programming Information 


This chapter provides the RSTS/E programming information. 


RMSDES Utility Summary 


The RMS-11 File Design Utility (RMSDES) allows you to design and 
create sequential, relative, and indexed files. 


The command line for the RMSDES utility is: 
DES filename[.typ] [type] 
Table 5-1 lists the RMSDES attribute settings and commands. 


Table 5-1: Attribute Settings 


Section 
Keyword Attribute Keyword and Variable Default 


System TARGET1 argument 


argument must be one of: 


RSX User’s system 
RSTS 
VMS 
SOURCE User’s system 
FILE PLACEMENT1 logical NO 

File NAME string FILE.DAT 
ORGANIZATION argument 
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Table 5-1 (Cont.): Attribute Settings 


Section 

Keyword Attribute Keyword and Variable Default 
argument must be one of: 
SEQUENTIAL SEQUENTIAL 
RELATIVE 
INDEXED 
CLUSTER_SIZE number 0 blocks 
ALLOCATION number 0 blocks 
EXTENSION number 0 blocks 
BUCKET_SIZE number 1 block 
PROTECTION string System protection 
OWNER string (RSX-11M/M PLUS only) _User’s UIC 
MAGTAPE_BLOCK_SIZE number 512 bytes 
REWIND_MAGTAPE logical NO 
MAX, RECORD_NUMBER number 0 records 
CONTIGUOUS logical NO 
SUPERSEDE logical NO 

Record SIZE number 0 bytes 


FORMAT argument 


argument must be one of: 


VARIABLE VARIABLE 
STREAM 

FIXED 

VFC 

CONTROL_FIELD_SIZE number 2 bytes 
BLOCK_SPAN logical YES 


CARRIAGE_CONTROL argument 
argument must be one of: 


CARRIAGE_RETURN NONE 
FORTRAN 

PRINT 

NONE 
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Table 5—1 (Cont.): Attribute Settings 
Section 
Keyword Attribute Keyword and Variable 
Key n NAME string 

TYPE argument 

argument must be one of: 


STRING 
BIN2 
BIN4 
INT2 
INT4 
DECIMAL 


NUIT T BWV laciaal 


a4ki_ tatu kb 1VRIvaL 
NULL_VALUE argument 
argument must be one of: 


An ASCII character 
A decimal number 


DUPLICATES logical 


SEGn_POSITION3 number 
SEGn_LENGTHS3 number 
SEGO_POSITION number 
CHANGES logical 
DATA_FILL number 
DATA_AREA number 
INDEX_FILL number 
LEVEL1_INDEX_AREA number 
INDEX_AREA number 
Area n ALLOCATION number 
EXTENSION number 
BUCKET_SIZE number 
CONTIGUOUS logical 
POSITION argument 
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Default 


No name 


STRING 


’ ? (space) 


NO (primary key) 
YES (alternate key) 


Byte 0 
0 bytes 
Byte 0 
YES (alternate key) 
100% 
Area 0 
100% 
Area 0 
Area 0 
0 blocks 
0 blocks 
0 blocks 
NO 
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Table 5-1 (Cont.): Attribute Settings 


Section 
Keyword Attribute Keyword and Variable Default 


argument must be one of: 


NONE NONE 
LOGICAL number 


Commands 


CLEAR ALL 
Restores all attribute values in all sections to their default values. 


CLEAR section ALL 
Restores all attribute values in the specified section to their default 
values. 


CLEAR section attribute 
Restores the specified attribute value in the specified section to its 
default value. 


CREATE [filenamel[.typ]] 

Creates an empty data file that has the attribute values specified in 
the design buffer. For indexed files in which areas are not defined, 
RMSDES prompts for whether areas are to be defined by default. 


If you do not specify a file name and type, the file will have those 
specified in the design buffer. If you did not specify a file name and 
type in the design buffer, the file will be created as FILE.DAT. 


Ctrl/Z 
Terminates RMSDES without saving the design or creating an empty 
data file. 


ESC 
In response to any prompt, returns the RMSDES utility prompt and 
preserves all attribute values in the design buffer. 


EXIT filename[.typ] 
Stores the file design in the description file specified in the command 
line and terminates RMSDES. The default file type is .DES. 
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GET filename[.typ] [type] 

Reads the file design specified in a description file, and sets the appro- 
priate attribute vaiues in the design buffer. Reads the attribute values 
of a data file, and sets the appropriate attribute values in the design 
buffer. The default file type is .DES. If the file is a data file, you must 
specify .DAT. 


HELP 
Lists all available help topics and gives instructions for displaying the 
text. 


HELP command 

Displays help text for the specified command. 

HELP SECTIONS 

Lists all available help topics for all sections and gives instructions for 
displaying the text. 


HELP section 
Displays help text for the specified section and lists all available help 
topics for all attributes in the specified section. 


HELP section attribute 
Displays help text for the specified attribute in the specified section. 
9 


Displays HELP text for the section, attribute, or value for which you 
are being prompted. Note also that you can type ? instead of HELP for 
any form of the HELP command. 


QUIT 
Terminates RMSDES, without storing the design or creating an empty 
data file. 


SAVE filename[.typ] 
Stores the file design in the description file specified in the command 
line. The default file type is .DES. 


SET ALL 
Prompts for setting all attribute values in all sections. For indexed files 
in which areas are not defined, prompts for whether areas are to be 


defined by default. 


SET section ALL 
Prompts for setting all attribute values in the specified section. 
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SET section attribute value 
Sets the specified attribute value in the specified section. 


SHOW ALL 
Displays all attribute values in all sections. 


SHOW section ALL 
Displays all attribute values in the specified section. 


SHOW section attribute 
Displays the specified attribute value in the specified section. 


SHOW ID 
Identifies the current level and patch version of RMSDES. 


RMSIFL Utility Summary 


The RMS-11 Indexed File Load Utility (RMSIFL) reads records from an 
RMS-11 file of any organization and loads them into an indexed file. 


The command line for the RMSIFL utility is: 
outfile[/switch...]=infile[/switch...] 
Type HELP or ? for a help message. 


Global Switch 


AID 
Identifies the current version. The default is to provide no identifica- 
tion. 


Output File Switches 


/ER(:filespec] 

Writes primary keys of exception records to your terminal if no filespec; 
or writes exception records to the specified file. The default is to write 
primary keys of exception records to your terminal. 

/NOER[:S] 

Stops processing if input record is incompatible. The default is to write 
primary keys of exception records to your terminal. 


/LO 
Honors bucket fill size. The default is to fill buckets to capacity. 
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/PD[:[# 1x] 
Pads input records to output record length. The default is to handle 
input records as exception records if the lengths differ. 


/TR 
Truncates input records to output record length. The default is to 
handle input records as exception records if the lengths differ. 


Input File Switches 


/CL:nnn 
Sets sort work files cluster size. 


/DE:dvn1:[dvn2:...dvn5:] 
Reassigns devices for sort work files. The default is to create and use 
sort work files on SY:. 


/KR:n 
Uses key of reference number. The default is to use primary key (0). 
/NOSO 


Does not sort records before loading. The default is to sort records in 
the input file before loading. 


RMSCNV Utility Summary 


The RMS-11 File Conversion Utility (RMSCNV) reads records from an 
RMS-11 file of any organization and loads them into another RMS-11 
file of any organization. 


The command line for the RMSCNV utility has the format: 
[outfile[/switch...]=linfile[/switch...] 


Global Switches 


/AP 
Appends records to an existing sequential file. The default is to not 
append records. 


/BL:[n] 
Sets magnetic tape block size. The default is 512 bytes. 


/CA:Lfilespec] 
Creates an output file with the attributes of the existing input file. 
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/EO 

Converts Ctrl/Z EOF character in an ASCII stream file to null and 
pads the file with nulls to the physical EOF. The default is to assume a 
null-filled stream file. 


/FO:x 
Sets output file organization, where x is S, R, or I. The default is S. 
AID 


Identifies the current version. The default is to provide no identifica- 
tion. 


/IM 
Processes files in block mode. The default is to use standard RMS-11 
access modes. 


/KN:["Jkeyname["] 

Reads an indexed file using the key of reference specified by keyname. 
The default is to use the primary key. 

/KR:n 

Reads an indexed file using the key of reference specified by n. The 
default is to use primary key (0). 


/LO 
Honors bucket fill size when filling buckets in an indexed file. The 
default is to fill buckets to capacity. 


/MA 

Uses mass-insertion mode and sequential PUT operations. The default 
is to use random PUT operations. 

/ML:n 

Explicitly sets limit of buffer allocation. 

/PDC#I x" 

Pads input records to the output record length, if necessary. The 
default is to not pad records. 


/SLL-filespec] 
Provides summary listing to terminal or in file, if specified. The default 
is to not provide a summary. 


/SU 
Supersedes existing sequential file. The default is to not su 
existing files. 
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/TR 
Truncates input records to output record length, if necessary. The 
default is to not truncate records. 


/WF 
Writes or read fixed-control area. The default is to ignore fixed-control 
area. 


RMSDSP Utility Summary 


The RMS-11 File Display Utility (RMSDSP) produces a concise descrip- 
tion of any RMS-11 file, including backup files. 


The command line for the RMSDSP utility has the format: 
[outfile=linfile[/switch...][,infile[/switch...]...] 


Global Switches 


/BP 
Lists contents of backup files. The default is to provide basic display 
only. 


/FU 
Provides detailed display for indexed files or backup files. The default 
is to provide basic display only. 


/ID 
Identifies the current version. The default is to provide no identifica- 
tion. 


RMSBCK Utility Summary 


The RMS-11 File Back-Up Utility (RMSBCK) transfers the contents of 
an RMS-11 file to another file, on another device, to maintain the file 
should the original file be lost or damaged. 


The command line for the RMSBCK utility has the format: 
outfile[/switch...]=infile[/switch...]L,infile[/switch...]...] 
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Global Switches 
AID 


Identifies the current version. The default is to provide no identifica- 
tion. 


/[[INO]QU 
Enables or disables query mode. The default is to enable query mode. 


/SL[-filespec] 
Provides summary listing to terminal or in file, if specified. The default 
is to provide no summary. 


Output File Switches 


/RW 
Rewinds magnetic tape before winding. The default is to not rewind 
magnetic tape. 


/SU 
Supersedes existing file. The default is to not supersede files. 


Input File Switches 


/CD:dd-mmm-yy[:v] 

Backs up files based on creation date: specify v as A to back up all 
files created after the date specified or as B to back up all files created 
before the date specified. If v is not specified, all files created on the 
date specified will be backed up. The default is to perform no date 
checking. 


/RD:dd-mmm-yy[:v] 

Backs up files based on revision date: specify v as A to back up all 
files revised after the date specified or as B to back up all files revised 
before the date specified. If v is not specified, all files revised on the 
date specified will be backed up. The default is to perform no date 
checking. 
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RMSRST Utility Summary 


The RMS-1i File Restoration Utility (RMSRST) restores files that were 
backed up using RMSBCK and produces standard RMS-11 files as 
output, so your programs can access them. 

The command line for the RMSRST utility has the format: 


outfile[/switch...]=infile[/switch...]Linfile[/switch...]...] 


Global Switches 


AID 

Identifies the current version. The default is to provide no identifica- 
tion. 

ANO]QU 

Enables or disables query mode. The default is to enable query mode. 
/SLL:filespec] 

Provides summary listing to terminal or in file, if specified. The default 
is to provide no summary. 


Output File Switches 


/FR 
Changes protection code. The default is to use the original protection. 


/SU 
Supersedes existing files. The default is to not supersede existing files. 


Input File Switches 


/BD:dd-mmm-yy 
Restores disk files based on backup date. The default is to perform no 
date checking. 


/OA:[p,pn] 

Restores files based on original account (PPN). Note that in this case, 
the square brackets are required syntax. The default is to apply no 
account criterion. 


/SE:filespec or 

/SE:(filespec1,filespec2[,...,filespec10]) 

Restores specified files from container file. The default is to restore all 
files on the container file. 
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BASIC-PLUS 


Commands 


The following sections summarize information about BASIC-PLUS 
commands, statements, statement modifiers, variable types, functions, 
relational operators, data storage, keywords, and the BASIC-PLUS 
Cross-Reference Program. 


This section describes BASIC-PLUS commands. Following each com- 
mand format is a brief description of the command function and where 
appropriate, an example. See the RST'S/E System User’s Guide for 
additional information about the commands marked with an asterisk. 
See the BASIC-PLUS Language Manual for additional information 
about the commands not marked with an asterisk (*). 


APPEND [filespec] 


Merges the lines from the saved source, overwriting any lines that exist 
in the current program. 


APPEND DMO: [12,12]PROG1.V2 
ASSIGN [dev]:[(proj,prog)] [logical name] 


Reserves an I/O device for use by a job. You can also use ASSIGN to 
assign a logical name to a device, assign an account to the @ character, 
or set the default protection code. ASSIGN can also accept extended 
user logical names. 


ASSIGN MTO: 
ASSIGN (200,200) 
ASSIGN DL3:[1,3] FOOBAR 


BYE 


You can use BYE as a system command only if the system manager has 
installed it as a system command. 


After you type BYE, press RETURN, and answer Y to the confirm 
prompt, the system logs you out and closes any open files. If you have 
defined BYE to be LOGOUT, the system logs you out without displaying 
the confirm prompt. 
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BYE 


CATALOG [dev:[(nroi prog) 


Displays a directory of your files. The default device is the system 
disk, but you can specify another device or account in the CATALOG 
command line. 


CATALOG DR3: [5,214] 


CCONT 


Continues execution of the current program after execution of a 
STOP statement but detaches the job from the terminal. Requires 
the JOBCTL privilege. 


CCONT 


COMPILE [filespec] 


Saves a translated image of the current program in a disk file. The 
default file name is the current program name; the default file type is 
.BAC. 


COMPILE DL1: [3,200]PROG1/PROT: 40 


CONT 


Continues execution of the current program after execution of a STOP 
statement. 


CONT 


DEASSIGN [dev]:[(proj,prog)] [logical name] 


Releases a device for use by other jobs. DEASSIGN also releases a log- 
ical name for a device, cancels the association between an account and 
the @ character, and changes the current default protection code back 
to the system default. The system performs an automatic DEASSIGN 
when you log out. 


DEASSIGN MTO: 
DEASSIGN (200,200) 
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DELETE [line number(s)] 


Removes one or more lines from the program in memory. Enter the 
DELETE command followed by the line number to delete the specified 
line, or a range of line numbers separated by a hyphen (-) to delete 
two or more lines. You can specify several single lines or ranges of 
lines by using commas to separate the line numbers or line number 
ranges. Typing DELETE with no line numbers deletes all lines from 
the current program. 


DELETE 0-200, 500 
EXIT 
Clears memory and returns control to the job keyboard monitor. 


EXIT 


EXTEND 


Puts BASIC-PLUS in EXTEND mode. You can write and run programs 
that include EXTEND mode features. However, the format require- 
ments for your program are more stringent in EXTEND mode than in 
NOEXTEND mode. See the BASIC-PLUS Language Manual for more 
information. 


EXTEND 
HELLO [(proj,prog)] 


You can use BYE as a system command only if the system manager has 
installed it as a system command. 


Informs RSTS/E that you want to log in. If you do not specify a project- 
programmer number, the system prompts you for one. You can also use 
HELLO to attach a detached job to your terminal or to change accounts 
without logging out. 


HELLO [5,214] 
KILL <string> 


Deletes the file specified by <string>. You must enclose the file specifi- 
cation within quotation marks. 
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LENGTH 


Returns the length of your current program, in 1K increments, and the 
maximum program size allowed. 


LENGTH 


LIST [line number(s)] 


Displays all or part of the program currently in memory. LIST by 
itself displays your entire program. LIST followed by one line number 
displays that line; LIST followed by two line numbers separated by 

a hyphen (-) displays a range of lines. You can display several single 
lines or ranges of lines by using commas to separate the line numbers 
or line number ranges. 


LIST 0-200,500 


LISTNH [line number(s)] 
Same as LIST, but does not print the header. 


LISTNH 0-200 


NEW [file name] 


Clears your memory area, names a new program, and lets you enter a 
new program at the terminal. The default program name is NONAME. 


NEW GETCHR 


NOEXTEND 


Sets BASIC-PLUS to the NOEXTEND mode. In NOEXTEND mode, 
EXTEND features are no longer available unless the program contains 
an EXTEND statement. 


NOEXTEND 
OLD [filespec] 


Retrieves a saved source program from disk and places it in memory. 
By default, OLD retrieves NONAME.BAS from your account on the 
public structure. 


OLD GETCHR.BAS 
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REASSIGN dev:job number 


Transfers control of a device to another job. When REASSIGN transfers 
control of the device to another job, it also prevents a third job from 
gaining control of that device. 


REASSIGN KB: 23 
RENAME file name 


Changes the name of the program currently in memory to the name 
that you specify. 


RENAME GETLIN 
REPLACE [filespec] 


Copies the source program currently in memory onto a disk file. The 
default file name is the current program name and the default file type 
is .BAS. Unlike the SAVE command, REPLACE overwrites an existing 
file having the same name. 


REPLACE NONAME.BAS 
RUN [filespec] 


Executes the program in memory. If you include a file specification, the 
system deletes the current program in memory, loads the specified file 
from disk, translates it if necessary, and executes it. 


RUN DM1: [200,233] TAXES 
RUNNH 


Executes the program in memory without printing the header, which 
contains the program name and current date and time. You can use 
RUNNH to run the current program only. 


RUNNH 
SAVE [filespec] 


Copies the source program currently in memory onto a disk file. The 
default file name is the current program name and the default file type 
is .BAS. SAVE does not replace an existing file having the same name. 


SAVE TAXES.BAS 


5-16 Programming Information 


Statements 


SCALE [n] 


Sets the scale factor to the value specified by n. When you do not 
specify n, SCALE displays the current and pending scale factors. 


SCALE 6 


UNSAVE [filespec] 


Deletes a file from a directory. The default file name is your current 
program name; the default file type is .BAS. 


UNSAVE TAXES.BAS 


This section describes BASIC-PLUS statements. After each statement 
format is a brief description of what the statement does, followed by 
examples of how to use the statement. 


[comments] 


Documents what your program does. BASIC-PLUS prints your com- 
ments when you list your source file, but they do not affect your 
program’s execution. See the REM statement. 

100 !This is a comment 

150 PRINT !Perform a CR/LF 

2000 GOTO 32767 IF END.OF.FILE% ! Quit if all done « 


\ PRINT ’End Pass’ N% ! Else log another pass & 
\ GOTO 1000 ! and start a new one 


CHAIN <string> [[LINE]<line number>] 
Transfers control from one BASIC-PLUS program to another. 
100 CHAIN "PROG3" LINE 75% ! Enter PROG3 at line 75 


CHANGE 


CHANGE { 


<array name> TO <string variable> 
<string variable> } <array hame> 
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Converts a list of numeric values to an ASCII string or an ASCII string 
to a list of numeric values. 


300 CHANGE X% TO xX$ ! Array X%() to string X$ 
450 CHANGE VS TO V% ! String V$ to array V%() 


CLOSE [#]<expression>[,[#]<expressions>.,...] 


Terminates I/O between a BASIC-PLUS program and a peripheral 
device or file. 


780 CLOSE #2% Close a single channel 


! 
800 CLOSE #2%, #3% ! Close two channels 
900 CLOSE #-CHAN% ! Close without writing buffer to file 
910 CLOSE #-CHAN% ! or delete a tentative file 


950 CLOSE #1I1% FOR I% = 1% TO 12% ! Close all channels 
DATA <value list> 

Stores data for input by the READ statement. 

1300 DATA 4.3, "STRING", 10, 1000, 1.45E9 
DEF*FN<variable(arguments)>=<expression (arguments)> 


Defines a single line of instructions to be a function. After you define 
a function, you can use that function as you use BASIC-PLUS-defined 


functions. 
120 DEF* FNRMS(X,Y,Z) = SQR(X**2% + Y**2% + Z**2%) ! Define & 
\ ! root-mean-square 


DEF* FN «<variable(arguments)> <statements> [LET]FN <variable> = 
<expression> FNEND 


Defines multiple lines of instructions to be a function. After you define 
a function, you can use that function as you use BASIC-PLUS-defined 


functions. 
300 DEF* FNF (M%) ! Factorial function 
310 IF M% = 0% OR M% = 1% & 


\ THEN FNF = 1% ! Handle terminal cases & 
\ ELSE FNF = Mt*FNF(M% - 1%) ! Handle others by recursion 
320 FNEND 


NOTE 


BASIC-PLUS supports both DEF and DEF* in single and 
multiline functions for compatibility with earlier versions. 
Use DEF* for compatibility with BASIC-PLUS-2. 
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DIM <variable(dim(s))>[,<variable(dim(s))>.,...] 
Specifies the size of an array. 


30 DIM A(20%), BS (6%,5%), C%(99%) ! Real, string (2-dim), & 
\ ! integer arrays 


DIM #<constant>,<stringvar(dim(s))>[=<constant>] [,<var(dim(s))>.,...] 
Specifies the size of a matrix of data in a virtual array. 


70 DIM #4, A$(100)=32%, B(50,50), C%(30) ! 3 virtual arrays on & 
\ ! channel #43 


END 


Closes all open I/O channels and halts program execution. 


EXTEND 


Puts your program into EXTEND mode until the program completes its 
run or until the program encounters a NOEXTEND statement. 


10 EXTEND ! Set EXTEND mode for following statements 


FIELD #<exp>, <exp1> AS <string vari>[,<exp2> AS <string var2>.,...] 
Dynamically associates string variables with parts of an I/O buffer. 


700 FIELD #2%, 10% AS A$, 20% AS BS, 5% AS C$ ! Define first 35 & 
\ ! bytes as 3 strings 


FOR <variable> = <exp> TO <exp> [STEP <exp>] 
Signifies the beginning of a FOR-NEXT loop. 


200 FOR I% = 2% TO 40% STEP 2% ! For 1% = 2%,4%,6%...40% & 

\ GOSUB 10000 ! This statement executes 20 times & 
\ NEXT 1% ! and I% is left equal to 40% 

300 FOR I% = 1% TO 40% STEP 2% ! For 1% = 1%,3%,5%...39% & 

\ GOSUB 10000 ! This statement executes 20 times & 
\ NEXT I% ! and I% is left equal to 39% 

400 FOR N =A TO (C+S1)/A ! Expressions can be & 

\ GOSUB 10000 ! more than single terms & 

\ NEXT N 
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NOTE 


Implied FOR loops use less memory and execute faster than 
FOR-NEXT loops. The following statements compare an 
implied FOR-NEXT loop with an explicit FOR-NEXT loop: 


10 R=R%* 2% FOR I% = 1% TO 10 % ! Implied FOR loop 
versus 
10 FOR I% = 1% TO 10% ! A full FOR-NEXT loop & 


\ R=R* 2% ! that is larger and slower 
\ NEXT I% ! than the implied FOR loop 


See "Statement Modifiers" for more information. 


FOR 
WHILE \ 


FOR <variable> = <expression> [STEP <expression>] { UNTIL 


<condition> 


Executes a loop while the condition that you specify is true, or until 
the condition that you specify is true, depending on whether you use 
WHILE or UNTIL. 


450 FOR I = 1. STEP 3. WHILE I < 12! For I=1, 4, 7, 10 & 
GOSUB 10000 Executes 4 times & 


t 
\ ‘NEXT I ! and I equals 13 
470 J = 0 ! Clear work variable & 
\ FOR I = 1. STEP 3. UNTIL J > 20 ! For I =1, 4, 7, 10 & 
\ J=Ot+T. ! Executes 4 times & 
\ “NEXT I ! and I equals 13, J equals 22 


NOTE 


Implied FOR-WHILE and FOR-UNTIL loops use less mem- 
ory and execute faster. The following examples show an 
implied FOR-WHILE loop and an implied FOR-UNTIL loop: 


450 GOSUB 10000 FOR I = 1. STEP 3. WHILE I < 12 ! FOR-WHILE 
470 J = J +1 FOR I=1. STEP 3. UNTIL J > 20 ! FOR-UNTIL 
See "Statement Modifiers" for more information. 
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GET 


GET<exp>, | { peconD } COUNT <exp>,USING <exp> | 


Reads the next sequential block from the file opened on the channel 
designated by the first expression when used without the BLOCK or 
RECORD option. Accesses a specific record or block when used with 
the BLOCK or RECORD option. 


120 GET #93% ! Sequential read on channel 9 

140 GET #2%, BLOCK 99. ! Read block 99 (record 99) on channel 4 
180 GET #4%, RECORD 50% 

200 GET #5% + SWAP%(3%), BLOCK 30% ! Read block 30 from channel & 
\ ! 5 into channel 3’s buffer. BLOCK is a real number and & 

\ ! RECORD is an integer. 


GOSUB <line numbers 


Transfers control to a subroutine beginning at the line number you 
specify. When the subroutine finishes, by encountering a RETURN 
statement, control returns to the statement following the GOSUB 
statement. 


190 GOSUB 2000 ! Perform the subroutine beginning at line 2000 & 
\ ! and then return to the statement following GOSUB 


GOTO <line number> 


Transfers control to a specific line number, with no return expected. 


100 GoTo 150 ! Transfer control to line 150, with no & 
\ ! return expected 


IF 


THEN <statement> 
IF <condition> < THEN <line number> 
GOTO <line number> 


Executes a statement or transfers control to another line if the condi- 
tion you specify is true. 


50 IF A> BOR B > C THEN PRINT "No" 
60 IF FNA(R) = B THEN 250 
75 IF L < X42% AND L <> 0. GoTo 1000 
90 IF TEST% THEN GOTO 300 
100 IF LEN (RESPONSES) THEN PRINT "OK" 


Two "conditions" tested 
Same as THEN GOTO 250 
Same as THEN GOTO 1000 
if nonzero, GOTO 300 

if not null, Print "OK" 


Ce ee) 
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IF 


THEN <statement> 
IF <condition> , THEN <line number> | 


ELSE <statement> 
GOTO <line number> 


ELSE <line number> 


Executes a statement or transfers control to another line if the condi- 
tion you specify is true, or executes another statement if the condition 
you specify is false. 


200 IF B = A THEN PRINT ’EQUAL’ ELSE PRINT ‘NOT EQUAL’ & 

\ ! IF-THEN-ELSE <statement> 

220 IF B = A THEN 1000 ELSE 300 ! IF-THEN-ELSE <line number> 
230 IF B = A GOTO 2000 ELSE PRINT ’B does not equal A’ & 

\ ! IF-GOTO-ELSE 


INPUT [#<expression>,]<variable list> 


Provides data to a program while the program is executing. The data 
can come from a device or file, depending on what you specify. 


100 INPUT AS 
200 INPUT "Enter your name";A$ 
300 INPUT #1%, ITEMS, PART 


INPUT LINE [#<expression>,]<string variable> 


Accepts a line of data as a single character string, including embedded 
spaces and punctuation. This is different from normal string input, 
where the comma, apostrophe, and single and double quotation marks 
have special meanings. 


300 INPUT LINE R$ 
400 INPUT LINE #8%, CUSTOMERS 


KILL "<string>" 


Deletes the file specification you specify in <string>. You must enclose 
the file specification within quotation marks. 


100 KILL ’OLD.DAT’ 
[LET] <variable(s)> = <expression> 


Assigns a value to each variable. 


110 LET A% = 40% 
120 B = 22. 
130 ¢c, Fi, V(0) = 0 ! Multiple assignment 
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LSET <string var>[,<string var>,...] = <string> 


Stores values in the variables without moving them from the I/O buffer. 
If the new string is shorter than an existing string, LSET pads the 
string with spaces on the right. 


100 LSET BS = /xyz’ 
{ZER} MAT <matrix name> = {CON} [(dim(s))] {IDN} 


Creates initial values for matrix elements. 


100 DIM B(15,10), A(10}, c%(5) 


120 MAT C% = CON 
130 MAT B% = IDN(10,10) 
140 MAT B% = ZER(N,M) 


MAT INPUT [#<expression>,] <list of matrices> 


Accepts as input the value of each matrix element. 
120 DIM B$(40), F1%(35) 


150 OPEN "DB2:MAT2.DAT" FOR INPUT AS FILE #3% 


180 MAT INPUT #3%, BS, F1% 
MAT PRINT 


MAT PRINT [#<expression>,] <matrix name> { - } 


Prints each element of a one- or two-dimensional matrix, except ele- 
ments in row 0 and column 0. 


150 DIM A(20), B%(15,30) 


200 MAT PRINT A, ! Print 20 elements, five on each line 
250 MAT PRINT B%(10,25); ! Print 10-by-25 subset of B%, packed 
300 MAT PRINT #2%, A; ! Print on channel 2 


MAT READ <list of matrices> 
Reads values into all matrix elements from DATA statements. 


100 DIM A(20), BS$(32), C%(15,10) 
200 MAT READ A, BS$(25), C% 


Programming Information 5-23 


NAME <string> AS <string> 


Renames or assigns protection codes to a disk file. 


100 NAME "NONAME" AS "FILE1.DAT/PR: 40" 
200 NAME ’DL1:MATRIX.DAT’ AS ’MATA1.DAT<48>’ 


NEXT [<variable>] 
Signals the end of a loop that begins with FOR, UNTIL, or WHILE. 


100 NEXT I% ! NEXT with a variable closes out the 
200 NEXT N_ ! FOR with that variable. 
300 NEXT ! NEXT by itself closes UNTIL-NEXT or WHILE-NEXT loop 


See the note under the FOR statement. 


NOEXTEND 


Puts your program into NOEXTEND mode until the program completes 
its run or until the program encounters an EXTEND statement. 


10 NOEXTEND ! Set NOEXTEND mode for following statements 
ON ERROR GOTO [<line number>] 


Specifies the point in your program that assumes control when an error 
occurs. 


100 ON ERROR GOTO 19000 ! Indicates errors handled at line 19000 
110 ON ERROR GOTO 0 ! Disables error-handling routine 


ON <expression> GOSUB <list of line numbers> 


Transfers control to a subroutine beginning at one of several line 
numbers, depending on the integer value of the expression. 


230 ON X% - Y¥% GOSUB 2000, 2400, 3000 ! If xX% - Y% = 1, then «& 
\ ! control goes to the subroutine beginning at line 2000. «& 
\ ! If X% - Y% = 2, then control goes to line 2400, and so forth. 


ON <expression> GOTO <list of line numbers> 


Transfers control to one of several line numbers, depending on the 
integer value of the expression. 


150 ON X% GOTO 170, 570, 430, 300 ! IF X%=1, then control goes & 
\ ! to line 170. If X%=2, then control goes to line 570, and so & 
\ ! forth. 
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OPEN 


FORINPUT ) | seunurn 
FOR OUTPUT / | AS FILE(#]<expression> 


[,.RECORDSIZE <exp>][,CLUSTERSIZE <exp>] [,FILESIZE 
<exp>][,MODE <exp>] 


OPEN <string> | { 1 


Associates a file or device with an I/O channel number. 


100 OPEN ’LP:’ FOR OUTPUT AS FILE #81% 
200 OPEN "FOO.DAT" AS FILE #3% 
300 OPEN ’DM1:DATA.TR’ FOR INPUT AS FILE #10%, RECORDSIZE 1024% 


PRINT [[#<expression>,] <list>] 


Prints numeric or string data at your terminal or writes formatted 
ASCII output to a disk file or other device. 


130 PRINT ! Produces CR/LF 

140 PRINT "Beginning of output:";I, A*I 
150 PRINT #2%, ’OUTPUT TO DEVICE’ ;N% 
160 PRINT "Title: ";TITLES, "Ref #";RS 


PRINT [#<expression>,] USING <string>, <list> 

Tailors the output format. The PRINT USING control characters are: 
For string data: 

! 

Prints the first character of the specified string. 


\ 
Prints two plus the number of characters indicated by the spaces 
between the backslashes. 
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For numeric data: 


# 
Prints a digit for each number sign indicated. Rounding (not trunca- 
tion) is performed as necessary. 


Prints a comma before every third digit to the left of the decimal point. 


Prints a decimal point in the position you indicate. 


$$ 
Prints a dollar sign immediately before the first digit of the number. 
Also provides for the printing of one additional digit in the number. 


he 
Prints asterisks in the unused spaces to the left of the number. Also 
acts as additional number characters (#). 


Prints the sign of negative numbers after the number when you end 
your numeric format field with a minus sign. 

AAAA 

Prints the number in E notation for floating point numbers. 


550 PRINT USING '##.##',AA 
700 PRINT #7%, USING BS, A,B,C 


PUT # 


BLOCK <exp> 


a | RECORD <exp> 


| [COUNT <exp>] [,USING 
<exp>] 


Writes the contents of the I/O buffer for the I/O channel into the next 
sequential file block. The PUT statement writes a single block on the 
device. For disk files, one PUT statement writes multiple disk blocks 
when you use the RECORDSIZE option in the OPEN statement to 
increase the I/O buffer size. 


390 PUT #1%, COUNT 80% ! Note that BLOCK is a real number and & 
\ ! RECORD is an integer. 
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RANDOMIZE] 


Provides different random numbers every time you run a program. 
Place the RANDOMIZE statement before the first RND function in the 
program. 


40 RANDOMIZE 
100 RANDOM 


READ «variable list> 


Reads values included in a DATA statement and stores those values in 
the corresponding variabies of the READ statement. 


100 READ A, BS, F1%, B(1%), R2 


REM <message> 


Informs BASIC-PLUS that <message> is a comment, which does not 
affect program execution. 


100 REM - This program plays solitaire 
RESTORE 


Recycles data contained in DATA statements. After you use RESTORE, 
the next READ statement reads the data contained in the DATA 
statement having the lowest line number. 


100 RESTORE 


RESUME [<line number>] 


Ends an error handling routine and transfers program control to the 
line number in which the error occurred, or optionally to a specified 
line number. 

1000 RESUME 0 ! Resume at line where error occurred 


2000 RESUME ! Equivalent to RESUME 0 
3000 RESUME 200 ! Resume at line 200 


RETURN 


Ends a subroutine and transfers program control to the statement 
following the last ON GOSUB or GOSUB statement executed. 


375 RETURN 
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RSET <string var>[,<string var>,...] = <string> 


Stores values in the specified variables without moving the values from 
the I/O buffer. If the new string is shorter than the existing string, 
RSET pads the string with spaces on the left. 


250 RSET C$ = "12345" 
SLEEP <expression> 


Suspends program execution for the specified number of seconds. 


260 SLEEP 20% ! Suspend job for 20 seconds 
STOP 


Halts program execution but does not close I/O channels. 


180 STOP 

UNLOCK #<expression> 

Releases the lock that an opened file, in update mode (MODE 1%), 
places on accessed blocks. 

500 UNLOCK #5% 

UNTIL <condition> 

Begins an UNTIL loop. 


100 UNTIL LEN(AS) > 0% 
110 NEXT 
200 PRINT "Thanks for the response!" 


WAIT <expression> 


Sets a maximum period BASIC-PLUS waits for input from your termi- 
nal. If you do not type a delimiter (RETURN, LINE FEED, ESCAPE, 
or FORM FEED) within the specified number of seconds, program 
execution continues and BASIC-PLUS displays the error message 
?Keyboard WAIT exhausted. 


520 WAIT 60% ! Wait 60 seconds for response to INPUT statement 
530 INPUT Name$ 
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WHILE <condition> 
Begins a WHILE loop. 


30 WHILE X < Y 

40 PRINT "X IS LESS THAN Y¥" 
50 X=X+1 

60 NEXT 


Statement Modifiers 


This section describes BASIC-PLUS statement modifiers. After each 
statement modifier format is a brief description of what the statement 
modifier does, followed by examples of how to use the statement 
modifier, 


{ WHILE 
UNTIL 


Creates an implied FOR loop. 


\ <condition>] | 


175 LET B$(I%) = CS(I%) FOR I% = 1% TO J1% 
190 READ A(I%) FOR I% = 0% TO 20% STEP J% 


<Sstatement> IF <condition> 

Executes a statement if the condition you specify is true. 

100 PRINT T% IF T% > T1% ! Prints T% only if T% is greater than T1% 
<Statement> UNLESS <condition> 


Executes a statement if the condition you specify is false. 


350 PRINT A$ UNLESS Y% < 0% ! Prints AS only if Y% & 
\ ! is greater than 0% 


<statement> UNTIL <condition> 
Executes a statement repeatedly, until the condition you specify is true. 


1080 X=X+1 UNTIL X<>SOR(X**2%) ! Increments X by 1 until X & 
\ ! is not equal to the square root of X squared. 
1200 PRINT X 
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<Statement> WHILE <condition> 


Executes a statement repeatedly, while the condition you specify is 


true. 


230 LET A(I%) = FNX(I%) WHILE A < 45.5 ! Sets the value of A(I%) & 


\ ! to FNX(I%) while A is less than 45.5 


Variable Types 


Table 5—2 describes BASIC-PLUS variable types. In EXTEND mode, 
a variable name can consist of a letter followed by 0 to 29 additional 
characters, each of which can be a letter, a digit, or a period. In 

NOEXTEND mode, a variable name can consist of a letter, optionally 


followed by a single digit. 


Table 5-2: Variable Types 


Type Variable Name 

Floating-Point A variable name with no suffix. 

Integer Any variable name followed by a % charac- 
ter. 

Character String Any variable name followed by a $ character. 

Floating-Point Array Any floating-point variable name followed by 


one or two dimension numbers in parenthe- 
ses. 


Integer Array Any integer variable name followed by one 
or two dimension numbers in parentheses. 


Character String Array Any string variable name followed by one or 
two dimension numbers in parentheses. 
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Examples 


AI X3 
Year.End 


B%, D%, 
End.Of.File% 


M$, R1$, 
Last. Name$ 


S(4%) 
V8(3%,3%) 
Year. End(12%) 


A%(2%), 
R2%(2%,1%), 
Units%(912%) 


C$(1%), 
V1$(4%,2%), 
Zodiac$( 12%) 


Functions 


This section describes BASIC-PLUS-defined functions. After each 
function format is a brief description of what the function does, followed 
by examples of how to use the function. 


ABS(X) 

Returns the absolute value of X. 

100 Y%=ABS({-4) ! Y% equals the absolute value of -4, which is 4 
ASCII(A$) 


Returns the ASCII value of the first character in string A$. 


an né_fanann? 
au Ay ADUUES 


100 Y%=ASCII(A$) ! Y% equals the ASCII value for A, which is 65% 


ATN(X) 

Returns the arc tangent (in radians) of X. 

150 Y=ATN(1.) ! Y= the arc tangent of one, which is (PI/2) 
BUFSIZ(N%) 


Returns the buffer size, in bytes, of the file or device open on channel 
N%. Returns zero if the channel is not open. 


50 Y%=BUFSIZ (1%) ! Y% equals the buffer size of the device or & 
\ ! file on channel 1% 


CCPOS(X%) 


Returns the current position of the print head for I/O channel X%. 
Channel 0% is your terminal. CCPOS counts characters but does not 
keep track of ESC sequences for different terminal types. 


100 PRINT IF CCPOS(0%)<>0 ! If the print head on the terminal & 


\ ! isn’t already at the left hand margin, print a RETURN/LINE & 
\ ! FEED to put it there 
CHR$(X%) 


Returns the character corresponding to ASCII value X%. 


100 YS=CHRS (65%) ! Y$ equals the character that has ASCII value «& 
! 65, which is uppercase A. 
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COMP%(A$,B$) 


Returns the relative value representing the result of an arithmetic 
comparison between numeric strings A$ and B$. Returns is -1% for 
A$<B$, 0% for A$=B$, and 1% for A$>B$. 


190 AS=’20’ 

195 BS='10’ 

200 T%=COMP%(A$,BS) ! T% equals 1%, because A$ is arithmetically & 
\ ! greater than B$ 

COS(X) 


Returns the cosine (in radians) of X. 


100 PRINT cOS(PI/4) ! Prints the cosine of (P1I/4), which is & 
\ ! .707107 


CVT%$(I%) 
Maps an integer into a two-character string. 


100 PRINT CVT%$(16706%) ! Prints AB, which is the two-character & 
\ ! string equivalent to the integer 16706% 


CVT$%(A$) 
Maps the first two characters of A$ into an integer. 


100 PRINT CVT$%(’ABCD’) ! Prints 16706, which is the integer $ 
\ ! equivalent of the first two characters 
! AB. 


CVTFS(X) 


Depending on the math package on your system supports, maps a 
floating-point number into a four- or eight-character string. 


200 FIELD #8%, 2% AS US, 2% AS CLS, 4% AS X$, 4% AS YS 

210 LSET US = CVT%$(U%) ! Stores two integers (U% and CL%) and 
220 LSET X$ CVTF$(X) ! two floating-point numbers (X and Y) in 
230 LSET Y$ CVTFS (Y) ! the I/O buffer for channel 8 
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CVT$F(A$) 


Depending on the math package your system supports, maps the first 
four or eight characters of A$ into a floating-point number. 


220 LET U%S = CVTS% (US) 

230 LET CL% = CVT$%(CLS) ! Retrieves data from the I/O buffer by 
240 LET X = CVTSF (XS) ! converting it from string to numeric 
250 LET Y = CVTSF (YS) ! form 


CVTS$S$(AS,I%) 
Converts string A$, depending on the value of I%. 


100 A$ = ‘abcde’ 
110 PRINT CVTS$$(AS,32%) ! Prints ABCDE 


Table 5—3 lists the values for the CVT$ function. 


Table 5-3: 1% Values for CVT$ Function 
1% Effect 
1 Trim the 8th bit. 
2 Discard spaces and tabs. 
A Discard RET, LF, FF, ESC, DEL, and fill or null characters. 
8 


Discard leading spaces and tabs. 


16 Reduce spaces and tabs to one space. 
32 Convert lowercase to uppercase. 
64 Convert square brackets to parentheses. For example, "[" to "(" and 
"J" to ")". 
128 Discard trailing spaces and tabs. 
256 Prevent alteration of characters inside single or double quotation 


marks, except parity bit trimming. 


DATES(N%) 


Returns the date string corresponding to the specified calendar date 
N%. To determine the value of N% given a particular day of the year 
and the year, use this formula: 


N% = (day of year) + [umber of years since 1970)*1000]. 
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For example, the value of N% for June 14, 1989 is: 
N% = (165) + (19 * 1000) = 165 + 19000 = 19165 


DATE$(19165%) returns 14-Jun-89. If your system default is the 
numeric date format, DATE$(19165%) returns 89.06.14. 


2000 PRINT "The date is "; 
2010 PRINT DATES (19365%) ! Prints 31-Dec-89 


DATE$(0%) 


Returns the current date in one of two formats: for example, 09-Apr-89 
or 89.04.09, depending on the date format your system supports. 


100 PRINT DATES (0%) ! Prints the current date 

DET 

Returns the determinant of X after an INV(X) operation. 
100 DIM M(15,25), N(5,10), X(5,5) 


110 MAT N=INV (xX) 
120 PRINT "DETERMINANT OF MATRIX X IS"; DET 


DIFS(A$,BS$) 

Returns the numeric string equal to the arithmetic difference of A$ and 
B$ (A$ - B$). 

110 PRINT DIF$(’5’, '3’) ! Prints the numeric string 2 

ERL 


Returns the line number at which the last error occurred, if an ON 
ERROR GOTO statement appears in the program. 


120 PRINT ERL ! Prints line number at which the last error & 
\ ! occurred 


ERR 


Returns the value associated with the last error encountered, if an ON 
ERROR GOTO statement was active. 


1000 PRINT ERR ! Prints numeric value of last error 
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EXP(X) 


Returns the value of the mathematical constant "e" (2.71828) raised to 
the Xth power. 


200 Y=EXP (3.5) 
FIX(X) 

Returns the integer part of X, discarding any fractional part. 
100 PRINT FIX(-3.14) ! PRINTS -3% 

INSTR(N1%,A$,B$) 


Performs a search for substring B$ within string A$, beginning at 
peniriees position N1%. Returns the character position of B$ if B$ is 
in Ag. Returns 0 if fBS$ i is Not in A$. IN1% is measured from the ieft end 


of A$. 


2000 PRINT INSTR(3%,’ABCDEABCDE’,’B’) ! Prints 7 because that & 


\ ! is the character position of the first B found after & 
\ ! position 3. 
INT(X) 


Returns the largest integer in X that is less than or equal to X. 


1000 PRINT INT(4.17), INT(-4.17) ! Prints 4 for 4.17 and & 
\ ! -5 for ~4.17 


INV(X) 
Returns the inverse of matrix X. 


10 DIM X(15,25), N(5,10), M(5,5) 
90 MAT N=INV(M) 


LEFT(A$,N%) 


Returns a substring of string A$, starting at the left end of A$ and 
ending at the N%th character. 


100 AS=’BASIC-PLUS SPEAKS MY LANGUAGE!’ 
110 PRINT LEFT (A$,10%) ! PRINTS BASIC-PLUS 
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LEN(A$) 
Returns the number of characters in A$, including blanks. 


2000 PRINT LEN(A$) ! Prints an integer representing the number & 
\ ! of characters in string A$ 


LINE 


Returns the line number of the statement being executed at the time of 
a CTRL/C interrupt. 


100 IF LINE < 200 PRINT GOSUB 3000 ! If a CTRL/C was entered & 


\ ! before line number 200, go to the subroutine beginning at & 
\ ! line 3000 
LOG(X) 


Returns the natural logarithm of X (log(e)X). 


350 PRINT LOG(10.) ! Prints natural logarithm of 10., which & 


\ ! is 2.30259 

LOG10(X) 

Returns the common logarithm of X (log(10)X). 

400 PRINT LOG10(100.) ! Prints common logarithm of 100. & 
\ ! which is 2 


MAGTAPE(F%,P%,U%) 
Performs special operations on magnetic tape. 
MID(A$,N1%,N2%) 


Returns a substring of A$, starting at character position N1% and 
continuing for N2% characters. N1% is measured from the left end of 
A$. 


1000 PRINT MID(’ABCDE’ ,3%,2%) ! Prints ’CD’ 
NUM 


Returns the number of rows input or the number of elements in a 
one-dimensional matrix, after input to a matrix. 


2500 PRINT ’NUM = ’;NUM ! Prints the number of rows or elements & 
\ ! for the one-dimensional matrix that just received input 
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NUMS$(N%) 


Returns a string of characters representing the value of N% as it would 


be displayed by the PRINT statement. 


500 PRINT NUMS$ (4%) ! Prints the string ’ 4 ', with spaces before & 


\ ! and after the numeric string. If the numeric string & 

\ ! represents a negative number, there is only a space after & 
\ ! the numeric string (for example, NUMS$(-4%) is ’-4 '). 
NUM1$(N%) 


Returns a string of characters representing the value of N%. NUM1$ 
is similar to NUM$, but does not return spaces or E format results. 


400 PRINT NUM1S$ (4%) ! Prints the string ’4’, with no spaces & 
\ ! before or after the string. 


NUM2 


Returns the number of elements entered in the last row of a two- 
dimensional matrix, after input te that matrix, 


700 PRINT ‘NUM2 =’;NUM2 ! Prints the number of elements entered & 
\ ! in the last row 


PI 
Returns the constant 3.14159... 


550 INPUT A 


560 IF A > PI GOTO 2000 ! If A is greater than 3.14159, transfers « 
\ ! control to line 2000 


PLACE$(A$,P%) 


Returns a numeric string equal to numeric string A$, rounded or 
truncated to P% places. 


100 PRINT PLACES (’3.14159’,4%) ! Prints the numeric string & 
\ ! 3.14159’ with the fourth character position to the right & 
\ ! of the decimal point rounded off 
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POS(X%) 


Returns the current position of the print head for I/O channel X%. 
Channel 0% is your terminal. 


100 PRINT IF POS(0%)<>0 ! If the print head on the terminal isn’t & 


\ ! already at the left hand margin, print a RETURN/LINE FEED & 
\ ! to put it there. POS is the same as CCPOS but you should & 
\ ! use CCPOS for compatibility with BASIC-PLUS-2. 
PROD$(A$,B$,P%) 


Returns the product of numeric strings A$ and B$ (A$*B$) rounded or 
truncated to P% places. 


100 PRINT PRODS (’3.14159’,’2’,2%) ! Prints numeric string '6.28’ 
QUO$(A$,B$,P%) 


Returns the quotient of numeric strings A$ and B$ (A$/B$) rounded or 
truncated to P% places. 


100 PRINT QUOS (’3.14159' ,'2',2%) ! Prints numeric string '1.6’ 
RAD$(N%) 


Converts the integer value of N% to a character string of up to three 
characters. Use this function to convert from Radix-50 format to ASCII. 
See the RSTS/E Programming Manual for more information. 


12000 PRINT RAD$(1%) ! Prints the letter A 
RECOUNT 


Returns the number of characters read following an input operation. 
Used primarily with non-file-structured devices. 


100 IF RECOUNT > 0 GOTO 2000 ! Transfers control to line 2000 if & 
\ ! more than zero characters were read 


RIGHT(A$,N%) 


Returns a substring of string A$, starting at the N%th character and 
ending at the right end of A$. N% is measured from the left end of A$. 


250 PRINT RIGHT ('’ABCDE’,3%) ! Prints the string ’CDR’ 


5-38 Programming Information 


RND 
Returns a pseudorandom number between 0 and 1. 


100 Y%=INT(6*RND+1) ! Y% equals a random number that simulates & 
\ ! the throw of a die 


RND(X) 


Returns a pseudorandom number between 0 and 1. X is a "dummy 
value", and has no effect on the random number selected. 


100 Y%=INT (6*RND(99)+4+1) ! Y% equals a random number that & 
\ ! simulates the throw of a die 


SGN(X) 


Returns the sign value of X. Returns +1 if positive, 0 if zero, and -1 if 
negative. 


100 PRINT SGN(-4.5) ! Prints -1 

SIN(X) 

Returns the sine (in radians) of X. 

900 PRINT SIN(PI/2) ! Prints 1, which is the sine of PI/2 


SPACES$(N%) 


Returns a string of N% spaces; used to insert spaces within a character 
string. 


2000 PRINT SPACES (5%); ! Prints 5 spaces 
SPEC% 


Performs special operations on disks, flexible diskettes, magnetic tapes, 
terminals, and pseudo keyboards. 


SOR(X) 
Returns the square root of X. 

100 PRINT SOR(16.) ! Prints the square root of 16., which is 4. 
STATUS 


Returns the status of the I/O channel most recently opened. 


Programming Information 5-39 


STRING$(N1%,N2%) 


Returns a string of length N1%. The string is composed of the charac- 
ter represented by the ASCII value N2%. 


100 PRINT STRINGS (10%,65%) ! Print the string ’ AAAAAAAAAA’ 


SUMS$(A$,B$) 

Returns a numeric string equal to the sum of numeric strings A$ and 
B$ (A$ + B$). 

200 PRINT SUM$(’1.5’,’3.275’) ! Prints the string 4.775 
SWAP%(N%) 


Causes a byte swap operation on the two bytes in the integer variable 
N%. 


1000 PRINT SWAP%(1%) ! Prints 256 

SYS 

Communicates with the RSTS/E monitor. See the RSTS/E Programming 
Manual for more information. 

TAB(X%) 


Moves the print head to position X% in the current print record. 
BASIC-PLUS ignores the function if the current position is beyond X%. 
The first print position is 0%. 


230 PRINT TAB(10%) ! Moves the print head to column 10 if the & 

\ ! print head position is currently less than 10, otherwise, & 
\ ! the print head remains where it is 

TAN(X) 


Returns the tangent (in radians) of X. 


240 PRINT TAN(PI/4) ! Prints the tangent of PI/4, which is 1. 
TIME(0%) 


Returns the clock time, in seconds as a floating-point number, since 
midnight. 


100 PRINT TIME (0%) /60 ! Prints the clock time in minutes 
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TIME(1%) 


Returns the central processor time, in tenths of seconds, used by the 
current job. 


2000 PRINT TIME(1%)*10 ! Prints CPU time used in seconds 
TIME(2%) 


Returns the connect time, in minutes, that you have been logged into 
the system for the current job. 


120 IF TIME(2%) > 60 GOSUB 2500 ! If the connect time is greater & 
\ ! than an hour, transfer control to the subroutine beginning & 
\ ! at line 2500 

TIME(3%) 


Returns the number of kilocore ticks (KCTs) as a decimal number for 
the current job. 


3000 PRINT TIME(3%) ! Print number of KCTs job has used thus far 
TIME(4%) 


Returns the number of minutes as a decimal number of device time for 
the current job. 


7800 PRINT TIME(4%) ! Prints number of device time minutes that & 
\ ! current job has used thus far 


TIME$(0%) 
Returns the current time of day as a character string. 


270 PRINT TIMES (0%) ! Prints the time in one of two formats & 
\ ! depending on your system’s default: 05:30 PM or 17:30 


TIMES(N%) 


Returns a string corresponding to the time of N% minutes before 
midnight. 


1000 PRINT TIMES (1440%) ! Prints the time in one of two formats & 
\ ! depending on your system’s default: 12:00 PM or 00:00 
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VAL(A$) 
Returns the numeric value of the string of numeric characters A$. 
200 IF VAL(AS) > 100 GoTO 2000 ! If the numeric value of the & 


\ ! string AS is greater than 100, control transfers to line & 
\ ! 2000 


XLATE(A$,B$) 


Translates A$ to a new string, using table string B$. See the 
BASIC-PLUS Language Manual for more information. 


Arithmetic, Numeric and String Relational Operators 


Table 5—4 describes the BASIC-PLUS arithmetic, numeric, and string 
relational operators. 


Table 5-4: Relational Operators 


Operator Example Meaning 
Arithmetic Operators 
+ A+B Adds BtoA 
- A-B Subtracts B from A 
i A*B Multiplies A by B 
/ A/B Divides A by B 
ms A*B Calculates A to the B power 
7 A**B Calculates A to the B power 
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Tabie 5-4 (Cont.): Relational Operators 


Operator Example Meaning 
Numeric Relational Operators 

= A=B A is equal to B 

< A<B A is less than B 

<= A<=B A is less than or equal to B 

> A>B A is greater than B 

>= A>=B Ais greater than or equal to B 

<> A<>B A is not equal to B 

== A==B A is approximately equal to B 

String Relational Operators 

= A$=B$ String A$ and B$ are equal, except for 
possible trailing spaces 

< A$<B$ String A$ precedes string B$ in ASCII se- 
quence 

<= A$<=B$ String A$ equals or precedes string B$ in 
ASCII sequence 

> A$>B$ String A$ follows string B$ in ASCII se- 
quence 

>= A$>=B$ String A$ equals or follows string B$ in 
ASCII sequence 

<> A$<>B$ Strings A$ and B$ are not equal 

== A$==B$ Strings A$ and B$ are identical, including 


trailing spaces 


Numeric and String Internal Data Storage 


The next three sections describe how BASIC-PLUS internally stores 
integer, floating-point, and string data. 
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Logical Operators 


Truth Tables for Logical Operations 


Examples: 


4 Setting (turning on) bits: 


85% = O000000001010101 
28% = 0000000000011100 
85% OR 28% = 0000000001011101 


2 Clearing (turning off) bits: 


85% = 0000000001010101 
28% = 0000000000011100 


85% AND 28% = 0000000000010100 
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NOTE 


The NOT operator flips the bits. To get NOT(N%), add 1 
algebraically and then change the sign. For example: 


Add 1 Change Sign 
NOT 5%: 5% +1% = 6% > -6% 
NOT -6% -6% +1% =-5% > 5% 


Logical (Boolean) values in BASIC-PLUS 


Testing by Setting by 
Boolean BASIC-PLUS BASIC-PLUS 
True Nonzero numbers Set to -1% 
False Zero Set to 0% 


For example, assume a BASIC-PLUS program that has the following 
line: : 


100 IF A% THEN GOTO 200 
If A% equals zero then the GOTO is not executed (A% is "false"). If A% 
is nonzero, A% is "true" and control passes to line 200. 

NOTE 


You can use non-Boolean true values, but be careful. For in- 
stance, suppose that A$ = ABCD’ and F$ = ’$NOTICE.TXT’. 
Consider the following statement: 


IF LEN(AS) THEN 100 


Control passes to line 100 because 4% (the length of A$) is 
"true". Now consider the following statement: 


IF INSTR(1%, FS, '.’) THEN 100 


Again, control passes to line 100 because F$ contains a 
period (’.’), and is thus true. 
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Be careful, however, when combining non-Boolean TRUE 
values (that is, true values other than -1%). For example: 


IF LEN(A$) AND INSTR(0%, FS, ’.’) THEN 100 


You might assume that if the length of A$ is true (nonzero) 
and string F$ contains a period, that the combined state- 
ments are true (true and true = true). This is not necessarily 
the case. If the length of A$ is 4% and the period in F$ is 

in the eighth position, for example, the 4% AND 8% = 0%, 
which is false. Thus, non-Boolean true AND non-Boolean 
true can equal false. 


Keep in mind that the logical operators evaluate all 16 bits 
of a PDP-11 word. The standard Boolean values are all bits 
0 for false, and all bits 1 (value -1%) for true. 


Integer Data 


BASIC-PLUS stores integer data in binary format. Each integer uses 
one PDP-11 word (16 bits). Integer values can range from -32768% to 
32767%. The following diagram shows the internal integer format: 


Bit. 15 1413 12 11109876543210 
S *— high byte —>| low byte >| 


Bits 0 through 14 each correspond to a positive power of 2. That is, if a 
1 occurs in bit position 5, then the value for that bit is (2%5) or (32). Bit 
15 stores the number’s sign; 0 means the number is positive; 1 means 
the number is negative. Positive integers range from 0% to 32767% 
and negative integers from -1% to -32768%. 
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The following example shows you sample bit patterns for both positive 
and negative integers: 


Positive Bit Pattern Negative Bit 
Integer Integer Pattern 
0 00000000 00000000 
+1 00000000 00000001 -1 . 11111111 
11111111 
+2 00000000 00000010 -2 11111111 
11111110 
+3 00000000 00000011 -3 11111111 
11111101 
+32767 01111111 11111111 -32768 10000000 
00000000 


Floating-Point Data 


BASIC-PLUS stores floating-point data in binary format. The number 
of PDP-11 words that the floating-point number uses depends on the 
math package that your system has: 


¢ If your system supports a single-precision math package, then each 
floating-point number uses two PDP-11 words. Single-precision 
math lets you accurately represent up to six decimal digits. 

¢ If your system supports a double-precision math package, then each 
floating-point number uses four PDP-11 words. Double-precision 
math lets you accurately represent up to fifteen decimal digits. 


Regardless of the math package that your system supports, floating- 


point numbers can range from approximately 10-38 to approximately 
10438. 
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The two diagrams that follow show the significance of each byte in 
single-precision and double-precision math packages: 


Single-Precision Math Double-Precision Math 


Byte 1 Byte 0 


Byte 7 Byte 6 


String Data 


A string is a sequence of ASCII characters treated as a unit. 
Theoretically, a string can contain up to 32767 characters, but in 
reality, the string is limited by the amount of available memory. 


The following diagram shows how strings are stored in a PDP-11 
computer. The diagram uses the string "ABCDEFG’ (the numbers to 
the left and right of the diagram are hypothetical PDP-11 addresses; 
the numbers inside the boxes represent the ASCII character codes for 
each character in the string ’ABCDEFG’). 


11 65% | 10 
13 67% | 12 
15 69% | 14 
17 71% | 16 


Note that the word at address 10 contains the ASCII codes for A and 
B. Byte 10 is the "low byte" of word 10, and byte 11 is the high byte of 
word 10. 
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Reserved Keywords 


Table 5-5 contains all words reserved for Digital versions of BASIC- 
PLUS and BASIC-PLUS-2. Do not use any of the listed words for a 
variable or function name. 


Table 5-5: Reserved Keywords for BASIC-PLUS and BASIC-PLUS-2 


ABS DESC IF ORGANIZATION STR$ 
ABS% DET IMP OUTPUT STREAM 
ACCESS DEF$ INDEXED PEEK STRING$ 
ALLOW DIM INPUT PI SUB 
ALTERNATE DIMENSION INSTR PLACE$ 

AND DUPLICATES INT POS SUBEXIT 
APPEND ECHO INV PRIMARY SUM$ 
AS EDIT$ KEY PRINT SWAP% 
ASCII ELSE KILL PROD$ SYS 

ATN END LEFT PUT TAB 
BACK EQ LEFT$ QUO$ TAN 

BEL EQV LEN RAD$ TAPE 
BLOCK ERL LET RANDOM TASK 
BLOCKSIZE ERN$ LF RANDOMIZE TEMPORARY 
BS ERR LINE RCTRLC THEN 
BUCKETSIZE ERROR LINPUT RCTRLO TIME 
BUFFER ERT$ LOC READ TIME$ 
BUFSIZ ESC LOG RECORD TO 

BY EXIT LOG10 RECORDSIZE TRM$ 
CALL EXP LSET RECOUNT TRN 
CCPOS EXTEND MAGTAPE REF UNDEFINED 
CHAIN FF MAP RELATIVE UNLESS 
CHANGE FIELD MAT REM UNLOCK 
CHANGES FILE MID RESET UNTIL 
CHR$ FILE$ MID$ RESTORE UPDATE 
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Table 5-5 (Cont.): 


CLOSE 
CLUSTERSIZE 
COM 
COMMON 
COMP% 

CON 
CONNECT 
CONTIGUOUS 
cos 

COUNT 

CR 

CTRLC 

CVT$$ 

CVT$% 

CVTS$F 
CVT%$ 
CVTF$ 

DATA 

DATE$ 

DEF 

DELETE 
DENSITY 


Reserved Keywords for BASIC-PLUS and BASIC-PLUS-2 


FILESIZE MODE RESUME USEROPEN 
FILL MODIFY RETURN USING 
FILL$ MOVE RIGHT VAL 
FILL% NAME RIGHT$ VAL% 
FIND NEXT RND VALUE 
FIX NOCHANGES RSET VARIABLE 
FIXED NODUPLICATES SCRATCH VIRTUAL 
FNEND NOECHO SEG% VT 
FNEXIT NONE SEQUENTIAL WAIT 

FOR NOREWIND SGN WHILE 
FORMAT$ NOSPAN SI WINDOWSIZE 
FROM NOT SIN WRITE 
FSP$ NUL$ SLEEP WRKMAP 
FSS$ NUM sO XLATE 

GE NUM$ SP XOR 

GET NUM1$ SPACE$ ZER 

GO NUM2 SPAN 

GOSUB ON SPEC 

GOTO ONECHR SQR 

GT ONERROR STATUS 

HT OPEN STEP 

IDN OR STOP 


BASIC-PLUS Cross-Reference Program (BPCREF) 


The BPCREF (BASIC-PLUS Cross Reference) program produces a 
cross-reference listing of a translated BASIC-PLUS (.BAC) program. 
When you enter BPCREF, you must specify the files you want pro- 
cessed. 
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To Run the Program 

RUN $BPCREF 

Format 

BPCREF command? output.crf=input.bac[,input.bas][/switches] 


where: 

output.crf Is the cross-reference listing file 
input.bac Is the translated file to process 
input.bas Is the source file to include in the listing 
/switches One or more optional qualifiers 


Usage Notes 


You do not have to specify output. If you do not specify output, do not 
specify the equal sign (=). BPCREF automatically produces an output 
file having the same name as the input file, but having the .CRF file 


type. 
BPCREF Switches 


/HEL[P] 

Displays information about BPCREF command formats. 
/NOD[ELETE] 

Informs the spooling program not to delete the output files after 
printing. 

/NOH[EADER] 


Omits header lines in the output file. The resulting .CRF file is more 
suitable as an input file to the FILCOM program. 


/P[AGE):nnn 
Specifies nnn as the number of lines per page to print in the output 
listing. The default is 60 lines per page. 


/Q(UUEVE] 
Automatically queues the output file to the line printer. BPCREF 


deletes the output file after printing unless you use the /(NODELETE 
switch. 
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/S[OURCE] 

Includes the source file in the output file. Use this switch when the 
.BAS file is in the same account and has the same file name as the 
.BAC file. Otherwise, specify the source file in the BPCREF command. 
/W[IDTH]:nnn 

Sets the width of the cross reference listing to nnn columns per line. 
The default width is 132 columns; the minimum width is 72 columns. 
/GL[OW}]:nnn 

/GH[IGH]:nnn 

Used as a pair, these switches specify a global listing. BPCREF prints 
line numbers and variables referenced both inside and outside the 
program boundaries indicated by the line numbers nnn. BPCREF does 
print line numbers or variables referenced only inside or outside the 


boundaries. The default value for /GL is 0 and the default value for 
/GH is 32767. 


/LLLOW]:nnn /LH[IGH]:nnn 

Used as a pair, these switches specify a local listing. BPCREF prints 
the line numbers and variables referenced inside the program bound- 
aries indicated by the line numbers nnn. BPCREF does not print line 
numbers or variables referenced outside the boundaries or referenced 
both inside and outside the boundaries. The default value for /LL is 0 
and the default value for /LH is 32767. 


/NO[CREF] 
Omits the full cross-reference listing. Use it when you want only a 
local or global listing. 


Devices 


This section contains the MODE value, RECORD value, and SPEC% 
information for six devices: 

¢ Disks 

¢ Flexible diskettes 

¢ Magnetic tapes 

e Line printers 

¢ Terminals 

* Pseudo keyboards 
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Disks 


Table 5—6 and Table 5—7 list the MODE values for file-structured and 
non-file-structured disk access. 


Table 5-6: MODE Values for File-Structured Disk Access (FIRQB + 


FQMODE) 
Decimal Octal Function 
0 Normal read/write 
1. 1 Update 
2. 2 Append 
A, 4 Guarded update 
8. 10 Special extend (RSTS/E updates file’s size and 
retrieval pointers during extend operations) 
16. 20 Create contiguous file 
32. 40 Create tentative file 
64. 100 Create contiguous file conditionally 
128. 200 No supersede 
256. 400 Random data caching (requires TUNE privi- 
lege) 
512. 1000 Create file and place at beginning of directory 
(with 2000) 
1024. 2000 Create file and place at end of directory 
2048. 4000 Sequential data caching (with 400) 
4096. 10000 Read normally regardless 
8192. 20000 Open file read-only 
16384. 40000 Write UFD (requires WRTNES privilege) 
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Table 5-7: 


Decimal 


16384. 


MODE Values for Non-File-Structured Disk Access (FIRQB 


+ FQMODE) 


Octal 


40000 


SPEC% Function for Disks 


The SPEC% function for disk files has the format: 
VALUE%=SPEC%(FUNCTION%, BLOCK, CHANNEL, 0%) 


where: 


VALUE% 


FUNCTION% 


Function 


Access device clusters. 
Access disk blocks. 


Read beyond last writable portion of disk; 
suppress error logging (RSTS/E uses this mode 
in its online DSKINT program. Digital does 
not recommend this for general use). 


Write to a mounted disk (requires WRTNFS 
and SYSMOD privileges). 


Depends on the particular function code you specify in 
FUNCTION%. In most cases, VALUE% is equal to the 
BLOCK parameter. 


Is a function code that specifies the desired operation. 


During normal I/O operations, a block, or range of blocks, is 
implicitly locked when you read the file with a BASIC-PLUS 
GET statement. The SPEC% function allows you to convert 
implicit locks to explicit locks and to release selected locked 
blocks. The code specified in FUNCTION% determines the 
use of SPEC%. The codes are: 
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FUNCTION% = 0% 
FUNCTION% = 1% 
FUNCTION&% = 2% 


FUNCTION% = 3% 


FUNCTION% = 4% 


Releases all locked blocks. 
Releases the current implicit lock. 


Converts the current implicit lock 
to an explicit lock. 


Releases the explicitly locked 
block specified in the BLOCK 
parameter. If BLOCK is 0, all ex- 
plicitly locked blocks are released. 
However, implicitly locked blocks 
remain locked. 

Converts an implicit lock to an 
explicit lock and release the 
implicit lock. 


BLOCK Specifies the starting block number for releasing an explicit 
lock. Note that BLOCK must be a floating-point number. 


CHANNEL% Is the I/O channel on which the operation is to be per- 


formed. 


0% Is the handler index for disk devices. 


Flexible Diskettes 


Table 5-8 and Table 5—9 list the MODE and RECORD values for 


flexible diskettes. 


Table 5-8: MODE Values for Flexible Diskettes (FIRQB + FQMODE) 


Decimal Octal Function 
0. 0 Read and write in block mode (default) 
16384. 40000 Read and write in sector mode 
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Table 5-9: RECORD Values for Flexible Diskettes (XRB + XRBLK) 


Decimal Octal Function 
8192. 20000 Access logical record 0 
16384. 40000 Write deleted data mark 
32767.+1. 100000 Perform this I/O operation in block mode 


SPEC% Function for Flexible Diskettes 


The SPEC% function for flexible diskettes has the format: 
VALUE%=SPEC%(FUNCTION%,PARAMETER,CHANNEL%,18%) 
where: 


VALUE Depends on the function code you specify in FUNCTION%. 
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FUNCTION% 


PARAMETER 
CHANNEL%&% 


18% 


Is a function code that specifies the desired operation. The 


codes are: 


FUNCTION% = 0% 


FUNCTIONG = 1% 


FUNCTION% = 2% 


Returns the density of the cur- 
rently mounted diskette in the 
format: 


DENSITY% = VALUE% AND 
255% 


If DENSITY%=1%, the diskette is 
single-density; if DENSITY%=2%, 
the diskette is double-density. 
Note that PARAMETER must 
also be 0. 


Causes the diskette driver to 
recompute density. If the diskette 
has been changed in the drive 
without closing and reopening 
the I/O channel, issue this code 
prior to any I/O operation on 
the diskette. This function also 
returns the computed density as 
described in FUNCTION%=0%. 
Note that PARAMETER must be 
0. 


Reformats the current diskette 
to the density in PARAMETER. 
PARAMETER equals 1 for single- 
density and 2 for double-density. 
Note that this operation is al- 
lowed only on RX02 drives and 
that any data on the diskette 
before the operation is lost. 


See the previous description of FUNCTION%. 
Is the I/O channel on which the operation is to be per- 


formed. 


Is the handler index for flexible diskettes. 
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Magnetic Tape 


Table 5—10 lists the MODE values for file-structured magnetic tapes. 


Table 5-10: MODE Values for File-Structured Magnetic Tape (FIRQB 


+ FQMODE) 
Decimal Octal Function 
0. 0 Read file label at current tape position 
2. 2 Do not rewind tape when searching for file 
16. 20 Write over existing file 
32. 40 Rewind tape before searching for file 
64. 100 Rewind on CLOSE 
128. 200 Open for append 
512. 1000 Write new file label without searching 
1024. 2000 For ANSI tapes. When record length (values 
0 - 4095) of the clustersize is 0, set the record 
length equal to the value specified for filesize 
16384. 40000 Search for DOS-formatted file label 
24576. 60000 Search for ANSI-formatted file label 


MODE Values for Non-File-Structured Magnetic Tape (FIRQB + 
FQMODE) 


MODE values in non-file-structured magnetic tape processing have the 


format: 

MODE(FIRQB+FQMODE) =D+P+S8S 

where: 

D(density) Is 12.(14) for 800 bpi and 256.(400) for 1600 bpi, phase- 
encoded. 

P(parity) Ts 0.(0) for odd and 1.(1) for even. Digital recommends the 


use of odd parity, because you cannot write binary data 
when you use even parity. 
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S(stay) Is 0.(0) to clear MODE value after CLOSE and 8192.(20000) 
to retain MODE value after CLOSE. 


SPEC% Function for Magnetic Tape 


The SPEC% function for magnetic tape has the format: 
VALUE%=SPEC%(FUNCTION%,PARAMETER,CHANNEL%,14%) 


where: 


VALUE% Depengs on the function code specified in FUNCTION%. 


FUNCTION% Is the function code. The SPEC% function performs various 
operations on tapes as determined by the FUNCTION% 


code, These eodes ara: 


eae VERS 


FUNCTION% = 1% 
FUNCTION% = 2% 
FUNCTION = 3% 
FUNCTION&% = 4% 
FUNCTION% = 5% 
FUNCTION% = 6% 
FUNCTION&% = 7% 
FUNCTION% = 8% 
FUNCTION% = 9% 
FUNCTION% = 10% 
FUNCTION% = 11% 


FUNCTION% = 12% 


Rewinds and puts it off line 
Writes tape mark 

Rewinds 

Skips record 

Backspaces over record 

Sets density and parity 
Returns tape status function 
Returns file characteristics 
Rewinds on CLOSE 

Writes EOV labels on CLOSE 
Acknowledges error condition 
(for asynchronous I/O) 

Sets extended density 


PARAMETER Depends on the function code specified in FUNCTION@. 


CHANNEL% Is the I/O channel on which the operation is to be per- 
formed. 
14% Is the handler index for magnetic tape. 


Line Printers 


Table 5—11 and Table 5-12 list the MODE and RECORD values for line 


printers. 
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Table 5-11: 
Decimal 


1. to 127. 


128. 
256. 


512. 


1024. 


2048. 


4096. 
8192. 


Table 5-12: 
Decimal 
2. 


4096 
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MODE Values for Line Printers (FIRQB + FQMODE) 


Octal 
1to177 


200 


400 


1000 


2000 


4000 


10000 
20000 


Function 


Sets form length to number of lines per page 
for software formatting (512., 1000) and au- 

tomatic page skip (2048., 4000). (This is the 
QUE system program’s LPFORM option.) 


Changes the character 0 (zero) to O (letter O). 


Truncates lines that are longer than unit was 
configured for instead of printing the rest of 
the line on the next physical line on the page. 


Enables software formatting. Forms control 
characters are >= 200(8). 


Translates lowercase characters to uppercase 
characters. Applies only to uppercase and 
lowercase line printers. 


Skips six lines (that is, skips over perforation 
line) at the bottom of each form. 


Moves paper to top of hardware form. 


Suppresses form feed on close. 


RECORD Values for Line Printers (XRB + XRMODE) 


Octal 
2 


10000 


Function 
Prints over perforation (disables MODE 4000 
for this output step). 


Does not return control to program until output 
is complete or an error occurs. 


Clears pending output buffers before buffering 
characters for the request. 


Truncates long lines (enables MODE 256% for 
this output step). 


Enables binary output, pass all characters to 
the device "as is”. 


Table 5—12 (Cont.): RECORD Values for Line Printers (XRB + 


XRMODE) 
Decimal Octal Function 
8192. 20000 Returns control to program if output stall 


is to occur. (See .WRITE directive for more 
information.) 


Terminals 


Table 5—13, Table 5-14, and Table 5—15 list the MODE and RECORD 
values for terminals and terminal input/output. 


Table 5-13: MODE Values for Terminals (FIRQB + FQMOD) 


Decimal Octal Function 
iL: 1 Enables binary input from a terminal 
2 2 Is reserved for TECO 
4. 4 Suppresses automatic CR/LF at right margin 
8 10 Enables echo control (turns off other modes 
and automatically enables MODE 4) 
16. 20 Guards program against CTRL/C interruption 
and dial-up line hibernation 
32. 40 Enables incoming XON/XOFF processing 
64. 100 Is reserved 
128. 200 Enables use of RUBOUT as a delimiter on 
video terminals 
256. 400 Sets escape sequence mode 
512. 1000 Uses no conditional sleep mode 
16384 40000 Enables transparent control character output 
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Table 5-14: 


RECORD Values for Terminal Input (XRB + XRMOD) 


Decimal and Octal 

Values Function 

8192. Performs conditional input (executes input request 
20000 without waiting for data to be available). 
32767.4+1.4K Performs multiterminal service input from assigned 
100000+K keyboard number K. 

32767.+1.4+16384.4+5 Performs multiterminal service input from any 
140000+S assigned keyboard: 

S=0 Waits until input is available 
from any terminal. The err ?Data 
error on device may occur due to 
a race condition with CTRL/C. 

1.<S<255. Waits up to S seconds for input 

1<S<377 from any terminal and then 
return ?Data error on device if no 
input is available. 

S = 8192. Requests input immediately; 

S = 20000 return ?Data error on device if no 
input is pending. 

Table 5-15: RECORD Values for Terminal Output (XRB + XRMOD) 
Decimal Octal Function 
256. 400 Declares echo control field (use 
with MODE 10). 
4096. 10000 Outputs binary data to terminal. 
8192. 20000 Returns control to program if out- 
put stall is to occur. (See .WRITE 
directive for more information.) 
16384. 40000 Uses transparent control charac- 
ter output. 
32767.4+1.4K 100000+K Performs multiterminal service 
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output to assigned keyboard K. 


SPEC% Function for Terminals 


The SPEC% function for terminals has the format: 
VALUE%=SPEC%(FUNCTION%,PARAMETER,CHANNEL%,2%) 


_ where: 


VALUE% 
FUNCTION% 


PARAMETER 


CHANNEL% 
2% 


Depends on the function code specified in FUNCTION%. 


Is the function code. The SPEC% function performs various 
operations on terminals as determined by the FUNCTION% 
code. These codes are: 


FUNCTIONG% = 0 Cancels Ctrl/O 

FUNCTIONG% = 1 Sets tape mode 

FUNCTIONG = 2 Enables echo and clear tape mode 
FUNCTION% = 3 Disables echo 

FUNCTION% = 4 Sets ODT mode 

FUNCTION% = 7 Cancels all type ahead 
FUNCTION% = 9 Clears all private delimiters 


Specifies the terminal on which the operation is to take 
place. If PARAMETER is 0, the operation is performed 

on the currently open terminal. If you specify a keyboard 
number in PARAMETER, the operation is performed on 
that terminal. Note that the keyboard must be assigned to 
the calling job but must not be open. 


Specifies the I/O channel for the terminal in PARAMETER. 


Is the handler index for terminals. 
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Pseudo Keyboards 


Table 5—16 and Table 5—17 list the MODE and RECORD values for 
pseudo keyboards. 


Table 5-16: MODE Values for Pseudo Keyboards (FIRQB + FQMODE) 


Decimal Octal Function 
0. 0 Kills controlled job when the pseudo keyboard is 
closed 
1. 1 Detaches controlled job when the pseudo keyboard is 
closed 


16. 16 Creates a new pseudo keyboard when used with PKO 


Table 5-17: RECORD Option Bit Values for Pseudo Keyboard Output 
(XRB + XRMOD) 


Value 
Bit Decimal Octal Result 
0 1. 1 If set, the system does not check job 
status before sending data to the pseudo 
keyboard. 
1 2. 2 If set, the system tests whether pseudo 


keyboard is waiting for a system com- 
mand (CTRL/C state) or is waiting for 
program input (KB wait state). 

2 4. 4 If set, the system does not send data to 
the pseudo keyboard but instead returns 
control to the controlling job. 

3 8. 10 If set, and there are no small buffers for 
keyboard input, the system waits until 
small buffers are available. However, 
your program receives the NOROOM 
error if the output buffer chain is full. 

4 16. 20 If set, the system kills the job currently 
running at the pseudo keyboard. 
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SPEC% Function for Pseudo Keyboards 


The SPEC% function for pseudo keyboards has the format: 
VALUE% = SPEC%(0%, PARAMETER%, CHANNEL%, 16%) 
where: 


VALUE% Is a flag word that contains information about the controlled 
job’s keyboard. By testing bit 5 in VALUE%, you can 
determine whether keyboard echo is enabled or disabled. 
The tests are: 

VALUE% AND 32% <> 0% Keyboard echo is disabled 
VALUE% AND 32% = 0% Keyboard echo is enabled 


PARAMETER% _ Specifies the operation to perform: 


0% Reads the flag word 
255% Enables echo 
-1% Disables echo 
CHANNEL% Specifies the I/O channel where the pseudo keyboard is 
open. 
16% Is the device handler index for pseudo keyboards. 


Character Sets 


This section contains the decimal and octal numerics for the following 
character sets: 


e ASCII 
e RADIX-50 
¢ 8-BIT 


RADIX-50 Character/Position Table 
This format allows three characters to be stored as a two-byte integer 


(one 16-bit word). The RAD$ function converts a Radix-50 word to its 
three-character representation. 
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Table 5-18 shows the complete set of characters that can be repre- 
sented in Radix-50 format, their ASCII octal equivalents, and the 
Radix-50 value for each character. 


Table 5-18: RADIX-50 Character/Position Numeric Values 


ASCH OCTAL 
Character EQUIVALENT £RADIX-50 Equivalent (Octal) 


space 40 0 
A-Z 101-132 1-32 
$ 4A 33 

‘ 56 34 

? 77 35 
0-9 60-71 36-47 


The following table lets you easily translate between the ASCII charac- 
ter set and its Radix-50 equivalents based on position within a string. 
The table contains the decimal value of each character as well as its 
octal value. 
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Table 5-19: ASClIli-to-RADIX-50 Conversion 


Single 
or First 
Character 


Second Third 
Character Octal Decimal | Character Decimal 


Decimal 


A 000001 A 000050 A 000001 1 
B 006200 B 000120 B 000002 2 
G 011300 C 000170 C 000003 3 
D 014400 D 000240 D 000004 4 
| o£ | 017500 | | o£ 000310 | E | coos | 35s 
F 022600 | 9600 F 000360 240 F 000006 6 
G 025700 | 11200 G 000430 280 G 000007 7 
H 031000 | 12800 H 000500 320 H 000010 8 
I 034100 | 14400 I 000550 360 000011 9 
| J | 037200 | 16000 | J | 000620 | 400 | J | 000012 | 10 | 
| K | 042300 | 17600 K 000670 440 K 000013 11 
L 045400 | 19200 L | 000740 | 480 | L | 000014 | 12 | 
M 050500 | 20800 M 001010 520 M 000015 13 
N 053600 | 22400 N 001060 560 N 000016 14 
O 056700 | 24000 fo) 001130 600 O 000017 15 
P | 062000 | =—.25600 P 001200 640 P 000020 i6 
Q 065100 | 27200 Q 001250 680 Q 000021 17 
R 070200 | 28800 R 001320 720 R 000022 18 
S 073300 | 30400 S 001370 760 S 000023 19 
iT 076400 | 32000 + 001440 800 T 000024 20 
U 101500 | 33600 U 001510 840 U 000025 21 
Vv 104600 | 35200 Vv 001560 880 V 000026 22 
w 107700 | 36800 WwW 001630 920 w 000027 23 
X 113000 | 38400 X 001700 960 X 000030 24 
Y 116100 | 40000 Y 001750 | 1000 Y 000031 25 
z 121200 | 41600 zZ 002020 | 1040 Z 000032 26 
$ 124300 | 43200 $ 002070 | 1080 $ 000033 27 
: 127400 | 44800 002140 | 1120 : 000034 28 
? 132500 | 46400 2 002210 | 1160 ? 000035 29 
0 135600 | 48000 0 002260 | 1200 0 000036 30 
1 140700 | 49600 1 002330 | 1240 1 000037 31 
2 144000 | 51200 2 002400 | 1280 2 000040 32 
3 147100 | 52800 3 002450 | 1320 3 000041 33 
4 152200 | 54400 4 002520 | 1360 4 000042 34 
5 155300 | 56000 5 002570 | 1400 5 000043 35 
6 160400 | 57600 6 002640 | 1440 6 000044 36 
7 163500 | 59200 7 002710 | 1480 7 000045 37 
8 166600 | 60800 8 002760 | 1520 8 000046 38 
9 171700 | 62400 9 003030 | 1560 9 000047 39 
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Table 5-20: ASCIil Character Set 


ASCII 


Kort fnat Kec OEa 


Null, FILL character = (‘i‘(is;é‘é~C~C* FILL character 
CTRL/A 

CTRL/B 

CTRL/C 

End of transmission, CTRL/D 
CTRL/E 

CTRL/F 

Bell, CTRL/G 
Backspace, CTRL/H 
Horizontal tab, CTRL/I 
Line feed, CTRL/J 
Vertical tab, CTRL/K 
Form feed, page, CTRL/L 
Carriage return, CTRL/M 
CTRL/N 

CTRL/O 

CTRL/P 

CTRL/Q*, XON 
CTRL/R 

CTRL/S**, XOFF 
CTRL/T 

CTRL/U 

CTRL/V 

CTRL/W 

CTRL/X 

CTRL/Y 

CTRL/Z, end of file 
Escape*** 

File Separator 

Group Separator 
Record Separator 

Unit Separator 

Space or blank 
Exclamation point 
Quotation mark 
Number sign 


OMNIA HWNHRH © 


“CTRL/Q, or XON, resumes output if the TTSYNC terminal characteristic is set. 
“*CTRL/S, or XOFF, stops output if the TTSYNC terminal characteristic is set. 
*** ALTMODE(ASCII 125) or PREFIX (ASCII 126) keys, which appear on some terminals, 
are translated internally into ESCAPE if the ALT MODE terminal characteristic is set. 


Grits 1S SS 
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Tabie 5—20 (Cont.): 


Decimal Character Remarks 


36 044 


| 39 | 047 
| 40 | 050 
41 051 
| 42 | 052 
43 053 
44 | 054 
45 055 
46 056 
47 057 
48 060 
49 061 
50 062 
51 063 
52 064 
53 065 
54 066 
55 067 
56 070 
57 071 
58 072 


WOOWONAAAWBNHRH ON: 


MOAWPOrYVIA:: : 


ASCil Character Set 


Dollar sign 
Percent sign 
Ampersand 
Apostrophe 

Left parenthesis 
Right parenthesis 
Asterisk 

Plus 

Comma 

Hyphen or minus 
Period or decimal point 
Slash 

Zero 

One 

Two 

Three 

Four 

Five 

Six 

Seven 

Eight 

Nine 

Colon 

Semicolon 

Left angle bracket, “less than” sign 
Equal sign 


Right angle bracket, “greater than” sign 


Question mark 
At sign 
Uppercase A 
Uppercase B 
Uppercase C 
Uppercase D 
Uppercase E 
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Table 5-20 (Cont.): ASCII Character Set 


ASCII 


ineeet °° > F 
Uppercase G 
Uppercase H 
Uppercase | 
Uppercase J 
Uppercase K 
Uppercase L 
Uppercase M 
Uppercase N 
Uppercase O 
Uppercase P 
Uppercase Q 
Uppercase R 
Uppercase S 
Uppercase T 
Uppercase U 
Uppercase V 
Uppercase W 
Uppercase X 
Uppercase Y 
Uppercase Z 
Left square bracket 
Backslash 
Right square bracket 
Circumflex 
Underscore 
Grave accent 
Lowercase a 
Lowercase b 
Lowercase c 
Lowercase d 
Lowercase e 
Lowercase f 
Lowercase g 


F 
G 
H 
I 
J 
K 
L 
M 
N 
O 
P 
Q 
R 
S 
T 
U 
Vv 
W 
Xx 
¥ 
Z 
[ 
\ 
] 
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Table 5—20 (Cont.): ASCIii Character Set 


See ee. ee 


New line 


150 h Lowercase h 
i Lowercase i 
2 j Lowercase j 
| 107 | 153 k | Lowercase k | 
108 154 I Lowercase | 
109 155 m Lowercase m 
116 156 n Lowercase fi 
| 111 | 157 | re) | Lowercase o | 
112 160 | p | Lowercase p 
113 161 q Lowercase q | 
114 162 r Lowercase r 
115 163 s Lowercase s 
' 116 164 t Lowercase t 
117 u Lowercase u 
118 Vv Lowercase v 
119 w Lowercase w 
120 x Lowercase x 
121 y Lowercase y 
122 Z Lowercase z 
123 { Left brace 
124 | Vertical line 
125 } Right brace *** 
126 a Tilde *** 
127 Delete 
128 Reserved 
129 Reserved 
130 Reserved 
131 Reserved 
132 Index 


Horizontal tab set 


Vertical tab set 


“CTRL/Q, or XON, resumes output if the TTSYNC terminal characteristic is set. 
**CTRL/S, or XOFF, stops output if the TTSYNC terminal characteristic is set. 
*** ALTMODE(ASCII 125) or PREFIX (ASCII 126) keys, which appear on some terminals, 
are translated internally into ESCAPE if the ALT MODE terminal characteristic is set. 
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Table 5-20 (Cont.): ASCII Character Set 


eee 


Partial line down 
Partial line up 
Reverse Index 
Single shift 2 

Single shift 3 
Device control string 


Reserved 
Reserved 
Reserved 
Control sequence introducer 
String terminator 


Reserved 
Inverted exclamation point 
Cent sign 

Pound sign 

Reserved 

Yen sign 

Reserved 

Section sign 

General currency sign 
Copyright sign 

Feminine ordinal indicator 
Angle quotation mark left 
Reserved 
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Table 5—20 (Cont.): 


[Decimal | Octal | Character Character Remarks 


ASCII Character Set 


173 255 Reserved 
Reserved 
| Reserved 
176 260 2 Degree sign 
| 177 261 | + Plus/minus sign 
178 262 . Superscript 2 
| 179 263 | _ Superscript 3 
180 264 Reserved 
181 265 B Micro sign 
182 266 q Paragraph sign, pilcrow 
183 267 . Middle dot 
184 270 Reserved 
Q Masculine ordinal indicator 
» Angle quotation mark right 
Wy Fraction one quarter 
Va Fraction one half 


Reserved 

Inverted question mark 

Uppercase A with grave accent 

Uppercase A with acute accent 

Uppercase A with circumflex accent 
Uppercase A with tilde 

Uppercase A with diaeresis or umlaut mark 
Uppercase A with ring 

Uppercase A with dipthong 

Uppercase C with cedilla 

Uppercase E with grave accent 

Uppercase E with acute accent 

Uppercase E with circumflex accent 
Uppercase E with diaeresis or umlaut mark 
Uppercase I with grave accent 

Uppercase I with acute accent 

Uppercase I with circumflex accent 


a 
i Superscript 1 


ee SV OE TD ON OTH) aa be D: Dib "by pea. 
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Table 5-20 (Cont.): ASCII Character Set 


Foacal Fel had An 


Uppercase I with diaeresis or umlaut mark 
Reserved 

Uppercase N with tilde 

Uppercase O with grave accent 

Uppercase O with acute accent 

Uppercase O with circumflex accent 
Uppercase O with tilde 

Uppercase O with diaeresis or umlaut mark 
Uppercase OE ligature 

Uppercase O with slash 

Uppercase U with grave accent 

Uppercase U with acute accent 

Uppercase U with circumflex accent 
Uppercase U with diaeresis or umlaut mark 
Uppercase Y with diaeresis or umlaut mark 
Reserved 

German lowercase sharp s 

Lowercase a with grave accent 

Lowercase a with acute accent 

Lowercase a with circumflex accent 
Lowercase a with tilde 

Lowercase a with diaeresis or umlaut mark 
Lowercase a with ring 

Lowercase ae dipthong 

Lowercase c with cedilla 

Lowercase e with grave accent 

Lowercase e with acute accent 

Lowercase e with circumflex accent 
Lowercase e with diaeresis or umlaut mark 
Lowercase i with grave accent 

Lowercase i with acute accent 

Lowercase i with circumflex accent 
Lowercase i with diaeresis or umlaut mark 
Reserved 


N 
e 
6 
0 
0 
6 
es 
® 
U 
U 
0 
u 
Y 


met ee mer ee  O2 O? Ov OO BW MWe M: MI oO Or O D 
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Table 5-20 (Cont.): ASCII Character Set 


ASCII 


[Decimal | Octal | Character | Remarks 


Lowercase n with tilde 


n 
38 Lowercase o with grave accent 
| | | fo) Lowercase o with acute accent 
244 364 6 Lowercase o with circumflex accent 
245 365 fe) Lowercase o with tilde 
246 366 fo) Lowercase o with diaeresis or umlaut mark 
| 247 | 367 | ce | Lowercase oe ligature | 
| 248 370 | ¢ Lowercase o with slash 
249 371 u Lowercase u with grave accent 
250 372 u Lowercase u with acute accent 
251 373 a Lowercase u with circumflex accent 
u Lowercase u with diaeresis or umiaut mark 
y Lowercase y with diaeresis or umlaut mark 


Reserved 
Reserved 
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RSTS/E System Errors 


Table 5—21 lists the severity standard in RSTS/E error messages. 


Table 5-21: 


Character 
% 


none 


Severity Standard in Error Messages 


Severity 


Warning 


Error 


Severe Error 


Information 


Meaning 


Execution of the program can con- 
tinue but may not generate the 
expected results. 


Execution cannot continue unless 
you remove the cause of the error. 


Execution cannot continue, and you 

probably cannot remove the cause of 
the error. In most cases, there is no 

opportunity for recovery. 


A message beginning with neither a 
question mark nor a percent is for 
information only. 


Table 5—22 lists the RSTS/E error messages. 


Table 5-22: RSTS/E Error Messages 


Mnemonic 


BADDIR 
BADNAM 
INUSE 
NOROOM 
NOSUCH 
NODEVC 
NOTCLS 
NOTAVL 
NOTOPN 
PRVIOL 
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Decimal 
Value 

1 1 
2 2 
3 3 
4 4 
5 5 
6 6 
7 7 
8 10 
9 11 
10 12 


Octal 
Value 


Full Error Text 


??Bad directory for device 
?Illegal file name 

?Account or device in use 
?No room for user on device 
?Can’t find file or account 
?Not a valid device 

?V/0 channel already open 
?Device not available 

?V/O channel not open 


?Protection violation 


Table 5-22 (Cont.): 


Mnemonic 


EOF 
ABORT 
DATERR 
HNGDEV 
HNGTTY 
FIEXST 
DTOOOF 
BADFUO 
INTLCK 
WRGPAK 
NOTMNT 
PAKLCK 
BADCLU 
PRIVAT 
INTPAK 
BADPAK 
DETKEY 
CTRLCE 
SATTBD 
DEVNES 
BADCNT 
NOBUFS 
B.4 

B.10 
B.250 
B.STAK 
B.SWAP 
B.PRTY 


Decimal 
Value 

11 

12 

13 

14 

15 


1 
a 


17 
18 
19 
20 
21 


22 
23 
24 
25 


26 
27 
28 
29 
30 
31 


Octal 
Value 


13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 


RSTS/E Error Messages 


Full Error Text 


?End of file on device 
??Fatal system VO failure 
?Data error on device 
?Device hung or write locked 
?Keyboard wait exhausted 
?Name or account now exists 
?Too many open files on unit 
?Nlegal SYS() usage 

?Disk block is interlocked 
?Pack IDs don’t match 

?Disk pack is not mounted 
?Disk pack is locked out 
?Illegal cluster size 

?Account does not exist 
%Disk pack needs REBUILDing 
??Disk pack mount error 
?1/0 to detached keyboard 
Programmable “C trap 
??Corrupted file structure 
?Device not file-structured 
?7Illegal byte count for /O 
?No buffer space available 
?0dd address trap 
?Reserved instruction trap 
?Memory management violation 
??SP stack overflow 

??Disk error during swap 


??Memory parity failure 
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Table 5-22 (Cont.): 


Mnemonic 


MAGSEL 
MAGRLE 
NRRTS 
VCSERR 
VCAERR 
SIZERR 
VCOERR 
BSERR 
LINERR 
FLTERR 
EXPERR 
FMTERR 
FIXERR 
BDNERR 
LOGERR 
SQRERR 
SUBERR 
MINVER 
ODD 
ONBAD 
NEDERR 
IOLERR 
DIVBYO 
NORTS 
FIELDE 
NORACS 
NOTMTA 
ERRERR 
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Decimal 
Value 

39 

40 

41 


SU Sh 8 ES 


RSTS/E Error Messages 


Octal 

Value Full Error Text 

47 ?Maptape select error 

50 ?Maptape record length error 
51 ??Non-res run-time system 
52 ?Virtual buffer too large 

53 ?Virtual array not on disk 
54 ?Matrix or array too big 

55 ?Virtual array not yet open 
56 ?IMegal YO Channel 

57 ?Line too long 

60 %¥ loating point error 

61 %Argument too large in EXP 
62 %Data format error 

63 %Integer error 

64 %lllegal number 

65 %Illegal argument in LOG 
66 %Imaginary square roots 

67 ?Subscript out of range 

70 ?Can’t invert matrix 

71 ?0ut of data 

72 ?70N statement out of range 
73 ?Not enough data in record 
74 ?Integer overflow, FOR loop 
75 %Division by 0 

76 ?No run-time system 

77 ?FIELD overflows buffer 
100 ?Not a random access device 
101 ?Illegal MAGTAPE( ) usage 
102 ?Missing special feature 


Table 5-22 (Cont.): 


Mnemonic 


BADSWT 
EOV 
QUOTA 
STMERR 
EXITTM 
EXITNR 
UNDFNI 
COSERR 
TLOPNV 
TLNZSP 
TLNOIT 
TLIFFE 
TLCONI 
TLNOTF 
TLQDUM 
TLMFND 
TLRNNM 
MODERR 
OUTAS 
FUNERR 
TLTMAF 
TLINCD 
CPNSDF 
CPUPFR 
CPUFNX 
CPUPDF 


Decimal 
Value 


67 


Octal 
Value 


103 
104 
105 
106 
107 
110 
111 
112 
113 
114 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 
131 
132 
133 
134 
135 
136 


RSTS/E Error Messages 


Full Error Text 


?Illegal switch usage 

?End of volume 

?Quota exceeded 

??Unused error message 70 
?Statement not found 
?RETURN without GOSUB 
?FNEND without function call 
?Undefined function called 
?Illegal symbol 

?Illegal verb 

?Illegal expression 

?Illegal mode mixing 
?Illegal IF statement 
?Illegal conditional clause 
?Illegal function name 
?Illegal dummy variable 
?Illegal FN redefinition 
?INegal line number(s) 
?Modifier error 

?Can’t Compile Statement 
?Expression too complicated 
?Arguments don’t match 
?Too many arguments 
%Inconsistent function usage 
?Ilegal DEF nesting 

?FOR without NEXT 
?NEXT without FOR 

?DEF without FNEND 
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Table 5-22 (Cont.): RSTS/E Error Messages 
Decimal Octal 


Mnemonic Value Value Full Error Text 

CPUPED 95 137 ?FNEND without DEF 
TLJINKY 96 140 ?Literal string needed 
TLNOFN 97 141 ?Too few arguments 

SASYNE 98 142 ?Syntax error 

SAFNOS 99 143 ?String is needed 

SASNOI 100 144 ?Number is needed 

TLURTP 101 145 ?Data type error 

TLXDIM 102 146 ?1 or 2 dimensions only 
FUCORE 103 147 ??Program lost-Sorry 

RESERR 104 150 ?RESUME and no error 
DIMED2 105 151 ?Redimensioned array 

TLIDIM 106 152 %Inconsistent subscript use 
NOGOTO 107 153 ?20N statement needs GOTO 
EOSERR 108 154 ?End of statement not seen 
TLCNTD 109 155 ?What? 

TLPRNM 110 156 ?Bad line number pair 
EDBMCE 111 157 ?Not enough available memory 
EDEXON 112 160 ?Execute only file 

NRNERR 113 161 ?Please use the RUN command 
EDCONE 114 162 ?Can't CONTinue 

EDARSV 115 163 ?File exists-RENAME/REPLACE 
PRERRS 116 164 ?PRINT-USING format error 
UDMERR 117 165 ?Matrix or array without DIM 
PRNERI1 118 166 ?Bad number in PRINT-USING 
NONOIM 119 167 ?Illegal in immediate mode 
PRNER2 120 170 ?PRINT-USING buffer overflow 
BADERR 121 171 ?Ilegal statement 

DISERR 122 172 ?IMegal FIELD variable 
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Table 5-22 (Cont.): 


Mnemonic 


STPERR 
DIMERR 
NOMATH 
XCDCOR 
SCAERR 


Decimal 
Value 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 


Octal 
Value 


173 
174 
175 
176 
177 
200 
201 
202 
203 
204 
205 
206 
207 
210 
211 
212 
213 
214 
215 
216 
217 
220 
221 
222 
223 
224 
225 
226 


RSTS/E Error Messages 


Full Error Text 


Stop 

?Matrix dimension error 
?Wrong math package 
??Maximum memory exceeded 
%SCALE factor interlock 
?Tape records not ANSI 

?Tape BOT detected 

?Key not changeable 

?No current record 

?Record has been deleted 
?Ilegal usage for device 
?Duplicate key detected 
?Illegal usage 

?Illegal or illogical access 
?Ilegal key attributes 

?File is locked 

?Invalid file options 

?Index not initialized 

?Illegal operation 

?Tllegal record on file 

?Bad record identifier 
?Invalid key of reference 

?Key size too large 

?Tape not ANSI labeled 
?RECORD number exceeds max 
?Bad RECORDSIZE on OPEN 
?Not at end of file 

?No primary key specified 
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Table 5-22 (Cont.): 


Mnemonic 
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Decimal 
Value 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 


Octal 
Value 
227 
230 
231 
232 
233 
234 
235 
236 
237 


RSTS/E Error Messages 


Full Error Text 


?Key field beyond record end 
?Illogical record accessing 
?Record already exists 
?Record/bucket locked 
?Record not found 

?Size of record invalid 
?Record on file too big 
?Primary key out of sequence 
?Key larger than record 
?File attributes not matched 
?Move overflows buffer 
?Cannot open file 

?No file name 

?Terminal fmt file required 
?Cannot position to EOF 
?Negative fill or string len 
?Megal record format 
?IHegal ALLOW clause 
??Unused ERROR message 169 
?Indexed not fully optimized 
?RRV not fully updated 
?Record LOCK failed 
?Invalid RFA field 
?Unexpired file date 

?Node name error 

?Negative TAB not allowed 
?Too much data in record 
?0PEN error - file corrupted 


Tabie 5-22 (Cont.): RSTS/E Error Messages 
Decimal Octal 


Mnemonic Value Value Full Error Text 

- 179 263 ??Unused ERROR message 179 
- 180 264 ?No support for op in task 

- 181 265 ?Decimal overflow 

_ 182 266 ?Network operation rejected 

_ 183 267 ?REMAP overflows buffer 

- 184 270 ?Unaligned REMAP variable 

_ 185 271 %RECORDSIZE overflows MAP 
- 186 272 ?Improper error handling 

- 187 273 ?illegal record lock clause 

- 188 274 ??Unused ERROR message 188 
- 189 275 ??Unused ERROR message 189 
_ 190 276 ??Unused ERROR message 190 
- 191 277 ??Unused ERROR message 191 
- 192 300 ??Unused ERROR message 192 
- 193 301 ??Unused ERROR message 193 
- 194 302 ??Unused ERROR message 194 
- 195 303 ??Unused ERROR message 195 
- 196 304 ?REMAP string is not static 

- 197 305 ??Unused ERROR message 197 
- 198 306 ??Unused ERROR message 198 
- 199 307 ??Unused ERROR message 199 
- 200 310 ??Unused ERROR message 200 
- 201 311 ??Unused ERROR message 201 
- 202 312 ??Unused ERROR message 202 
- 203 313 ??Unused ERROR message 203 
- 204 314 ??Unused ERROR message 204 
- 205 315 ??Unused ERROR message 205 
— 206 316 ??7Unused ERROR message 206 
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Table 5-22 (Cont.): 


Mnemonic 


5-84 Programming Information 


Decimal 
Value 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 


Octal 
Value 
317 
320 
321 
322 
323 
324 


RSTS/E Error Messages 


Full Error Text 


??7Unused ERROR message 207 
??7Unused ERROR message 208 
??Unused ERROR message 209 
??Unused ERROR message 210 
??7Unused ERROR message 211 
??Unused ERROR message 212 
??Unused ERROR message 213 
??7Unused ERROR message 214 
??7Unused ERROR message 215 
??Unused ERROR message 216 
??Unused ERROR message 217 
??7Unused ERROR message 218 
??Unused ERROR message 219 
??7Unused ERROR message 220 
??Unused ERROR message 221 
??Unused ERROR message 222 
??Unused ERROR message 223 
??Unused ERROR message 224 
??7Unused ERROR message 225 
??Unused ERROR message 226 
?String too long 
?RECORDTYPES not matched 
?7Unused ERROR message 229 
?No fields in image 

?Illegal string image 

?Null image 

?Illegal numeric image 


?Numeric image for string 


Table 5-22 (Cont.): RSTS/E Error Messages 


Decimal Octal 


Mnemonic Value Value Full Error Text 

- 235 353 ?String image for numeric 

- 236 354 ?TIME limit exceeded 

- 237 355 ?1st arg to SEQ$ > 2nd 

- 238 356 ?Arrays must be same DIM 
- 239 357 ?Arrays must be square 

- 240 360 ?7Cannot change array DIMs 
— 241 361 ?Floating overflow 

- 242 362 ?Floating underflow 

- 243 363 ?CHAIN to non-existent line 
_ 244 364 ?Exponentiation error 

- 245 365 ?Illegal exit from DEF* 

- 246 366 ?Error trap needs RESUME 
- 247 367 ?Illegal RESUME to SUBR 
- 248 370 ?Illegal subroutine return 

- 249 371 ?Argument out of bounds 

_ 250 372 2Not implemented 

- 251 373 ?Recursive subroutine call 

_ 252 374 ?FILE ACP failure 

— 253 375 ?Directive error 

- 254 376 ??Unused ERROR message 254 
- 255 377 ??Unused ERROR message 255 


Table 5-23 lists the RMS error messages. 
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Table 5-23: RMS Error Messages 


Mnemonic 


SU$SUC 
SU$DUP 


SU$IDX 
ER$ACC 
ER$ACT 
ER$AID 
ER$ALN 
ER$ALQ 
ER$ANI 
ER$AOP 
ER$ATR 
ER$ATW 
ER$BKS 
ER$BKZ 
ER$BOF 
ER$BPA 
ER$BPS 
ER$CCR 
ER$CHG 
ER$CHK 
ER$CLS 
ER$COD 
ER$CRE 
ER$CUR 


ER$DAN 
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Decimal 
Value 


Octal Value Full Error Text 
COMPLETION CODES 

000001 Operation succeeded 

000002 Inserted record has duplicate 
key 

000003 Error updating index 

177740 File access error 

177720 Activity precludes operation 

177700 Bad value in AID field 

177660 Bad mask in ALN field 

177640 Bad value in ALQ field 

177620 Bad ANSI-format magtape file 

177600 Bad mask in AOP field 

177540 Error reading attributes 

177520 Error writing attributes 

177500 Bad value in BKS field 

177460 Bad value in BKZ field 

177430 Beginning-of-file found 

177420 Bad address in BPA field 

177400 Bad value in BPS field 

177340 RAB already in use 

177320 Illegal record key change 

177300 Bad bucket header 

177260 File processor error 

177240 Bad code in COD field 

177220 File processor error 

177200 Undefined current-record 
context 

177140 Bad value in DAN field 


Table 5-23 (Cont.): RMS Error Messages 


Decimal 
Mnemonic Value Octal Value Full Error Text 
COMPLETION CODES 

ER$DEL -432 177120 Record having RFA deleted 

ER$DEV -448 177100 Bad device specification 

ER$DFW -456 177070 File processor error 

ER$DIR -464 177060 Bad directory specification 

ER$DME -480 177040 Pool exhausted 

ER$DNA -488 177030 Bad address in DNA field 

ER$DNF -496 177020 No such directory 

ER$DNR -512 177000 Device not ready 

ER$DPE -520 176770 Device positioning error 

ER$DTP -528 176760 Bad code in DTP field 

ER$DUP -544 176740 Duplicate key not allowed 

ER$SENV -576 176700 Feature not in selected RMS- 
11 environment 

ER$EOF -592 176660 End-of-file reached 

ER$ESA -600 176650 Bad address in ESA field 

ER$ESL -604 176644 Bad value in ESL field 

ER$ESS -608 176640 ESS field value too small 

ER$EXP -616 176630 File expiration date not yet 
reached 

ER$EXT -624 176620 File processor error 

ER$FAC -656 176560 FAC field forbids operation 

ER$FAL -664 176550 Operation not supported by 
remote node 

ER$FEX -672 176540 File already exists 

ER$FID -680 177530 Bad value in FID field 

ER$FLG -688 176520 Bad mask in FLG field 

ER$FLK -704 176500 File locked by another task 
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Table 5-23 (Cont.): 


Mnemonic 


ER$FNA 
ER$FNF 
ER$FNM 
ER$FOP 
ER$FSS 
ER$FUL 
ER$IAN 
ER$IDX 
ER$IFI 
ER$IMX 
ER$IOP 
ER$IRC 


ER$ISI 
ER$KBF 
ER$KEY 
ER$KRF 
ER$KSZ 
ER$LAN 
ER$LBL 
ER$LBY 
ER$LCH 
ER$LEX 
ER$LOC 
ER$MEM 
ER$MKD 
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RMS Error Messages 


Decimal 
Value 


Octal Value Full Error Text 
COMPLETION CODES 

176470 Bad address in FNA field 

176440 File not found 

176420 Bad file name 

176400 Bad mask in FOP field 

176370 Bad merged string 

176360 Device or file allocation failure 

176340 Bad value in IAN field 

176320 Index not initialized 

176300 Bad value in IFT field 

176260 Too many XABs of same type 

176220 Illegal operation for file 

176200 Illegal record found in sequen- 

tial file 

176160 Bad value in ISI field 

176140 Bad address in KBF field 

176120 Bad key 

176100 Bad value in KRF field 

176060 Bad value in KSZ field 

176040 Bad value in LAN field 

176020 Bad magtape label 

176000 Logical channel busy 

175760 Bad value in LCH field 

175750 Extension not needed 

175740 Bad value in LOC field 

175710 Memory address rollover 

175700 File processor error 


Table 5-23 (Cont.): RMS Error Messages 


Decimal 
Mnemonic Value Octal Value Full Error Text 
COMPLETION CODES 

ER$MRN -1104 175660 Bad value in MRN field or bad 
record number 

ER$MRS -1120 175640 Bad value in MRS field 

ER$NAE -1128 175630 Unmappable network access 
error 

ER$NAM -1136 175620 Bad address in NAM field 

ER$NEF -1152 175600 Context not end-of-file 

ER$NET -1160 175570 Network link lost 

ER$NMF -1172 175554 No more matching files 

ER$NOD -1176 175550 Bad Node Name 

ER$NPK -1184 175540 No primary key for indexed file 

ER$OPN -1200 175520 File processor error 

ER$ORD -1216 175500 Ordering of XABs illegal 

ER$ORG -1232 175460 Bad mask in ORG field 

ER$PLG -1248 175440 Error reading file prologue 

ER$PLV -1256 175430 File prologue version level 
unsupported 

ER$POS -1264 175420 Bad value in POS field 

ER$PRM -1280 175400 Bad file date read 

ER$PRV -1296 175360 Privilege violation 

ER$RAC -1328 175320 Bad mask in RAC field 

ER$RAT -1344 175300 Bad mask in RAT field 

ER$RBF -1360 175260 Bad address in RBF field 

ER$RER -1376 175240 File processor error 

ER$REX -1392 175220 Record already exists 

ER$RFA -1408 175200 Bad value in RFA field 

ER$RFM -1424 175160 Bad code in RFM field 
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Table 5-23 (Cont.): RMS Error Messages 


Decimal 
Mnemonic Value Octal Value Full Error Text 
COMPLETION CODES 

ER$RLK -1440 175140 Record locked 

ER$RNF -1472 175100 No such record 

ER$RNL -1488 175060 Record not locked 

ER$ROP -1504 175040 Bad mask in ROP field 

ER$RPL -1520 175020 File processor error 

ER$RRV -1536 175000 Bad internal pointer 

ER$RSL -1556 174754 Bad value in RLS field 

ER$RSS -1560 174750 Bad value in RSS field 

ER$RST -1564 174744 Bad address in RSA field 

ER$RSZ -1568 174740 Bad value in RSZ field 

ER$RTB -1584 174720 Record too big for user buffer 

ER$RVU -1592 174710 Internal pointer corrupted 

ER$SEQ -1600 174700 Sequential insertion records 
not in order 

ER$SHR -1616 174660 Bad mask in SHR field 

ER$SIZ -1632 174640 Bad value in SIZ field 

ER$SUP -1656 175610 Operation not supported over 
network 

ER$SYS -1664 174600 System error 

ER$TRE -1680 174560 Index error 

ER$TYP -1696 174540 Bad file extension 

ER$UBF -1712 174520 Bad address in UBF field 

ER$UIN -1720 174510 Field value rejected by FAL 

ER$USZ -1728 174500 Bad value in USZ field 

ER$VER -1744 174460 Bad file version number 

ER$WCD -1768 174430 Megal wildcard in merged 
string 
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Table 5-23 (Cont.): RMS Error Messages 


Decimal 
Mnemonic Value Octal Value Full Error Text 
COMPLETION CODES 
ER$WER -1776 174420 File processor error 
ER$WLK -1784 174410 Device write-locked 
ER$WPL -1792 174400 File processor error 
ER$XAB -1808 174360 Bad address in XAB field 
ER$XTR -1824 174340 Extraneous data in file specifi- 


cation 


was 


FATAL ERROR COMPLETIONS 


ER$ACT -48 177720 Illegal concurrent operation 

ER$AST -144 177560 Illegal operation at AST level 

ER$BUG -272 177360 Error in RMS-11 internal data 

ER$CPB -360 177230 Bad parameter block 

ER$FAB -640 176600 Bad FAB 

ER$LIB -1052 175744 Resident library not available 

ER$MAP -1072 175720 Error in internal buffer map- 
ping data 

ER$RAB -1312 175340 Bad RAB 


Syntax and Parsing 


The following sections provide information on Command Syntax and 
Parsing. 


Command Syntax 


The following lines show the proper syntax for a CCL command called 
COMMAND. (Note that ’<anything>’ represents characters that the 
CCL parser does not process): 


COM[MAND] [<switch(es)>] [/<anything>] 
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COM[MAND] [<switch(es)>] [<space><anything>] 

The command line may contain two switches: /SI and /DET. 
The format for the /SI switch is: 
[<space>)/SI[ZE]:[+][#]<digits>[.] 


where: 

/SI Denotes the size in K words to which the program must ex- 
pand. 

Terminates the /SIZE switch. 

+ Designates an increment in size over the program’s usual size. 
Without the plus sign, the digit’s value is the total size in K 
words to which the program should expand. 

# Indicates the digit’s value is given in octal. The default is 
decimal. 

<digits> Is the value for size, in K words. Size can be neither less than 


1 nor greater than 32 (decimal). 
Explicitly indicates a decimal value for digits. 


The format for the /DET switch is: 
[<space>/DET[ACH] 


Where /DET indicates that the program is to run detached from the 
job’s console terminal. 


Command Parsing 


The run-time system passes the command line to the CCL parser. 
When the CCL parser receives a command string, it: 

1. Translates the string 

2. Checks the string for a valid CCL command 


3. Writes the fully expanded CCL command into core common, and 
ensures that it is delimited by a space 


Checks the remaining string for both of the valid CCL switches 
Writes the remaining line (excluding CCL switches) to core common 
Sets up the CCL program to run 

Sets a flag from data in the CCL command definition block 


Soe ee 
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8. Passes control back to the program’s run-time system, which, 


in turn, runs the program (at the appropriate line number for 
BASIC-PLUS programs) 


The BASIC-PLUS run-time system then: 


1. Sets the STATUS variable 
2. Checks the line number at which the program is to be entered 
3. Checks whether the program is to be detached 


BASIC-PLUS sets the STATUS variable according to the rules in 
Table 5-24. 


Table 5-24: BPSTATUS Variable Bits 


Bit 
0-7 


8-12 
13 


14 


15 


Test 
(STATUS AND 255%) 


(STATUS AND 8192%) 


(STATUS AND 16384%) 


(STATUS < 0%) 


Meaning 


If bit 13 is 0, this byte must be 

0. If bit 13 is 1, this byte is the 
size value n (in decimal) passed 

in the /SIZE:n switch or is -n to 
indicate that the size value was 
passed in the /SIZE:+n switch (the 
plus character preceded the size 
value). (To determine whether the 
size value is negative, check the most 
significant bit by the (STATUS AND 
128%) test.) 


Reserved for future use. 


If the /SIZE:n switch was specified, 
this bit is 1. 

If the /DET switch was specified, this 
bit is 1. 


This bit is always 1 (the value of 
STATUS is always negative for a 
CCL entry.0 
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Appendix A 


OPSER and Obsolete System Utility 
Programs 


This appendix describes the OPSER and obsolete system programs. 


BATCH (OPSER-based) 


BATCH lets you process work that can be run in your absence. You run 
a batch job by first putting batch commands into a control file that you 
create. 


Privilege Required 


¢ Read access to the files you are submitting 
¢ Write access to use /DELETE 


To Run the Program 


RUN $QUE 

Format 

#Q BA:BATJOB.LOG=FILE1.CMD,FILE2.CTL 
$BASIC Command 

Calls a BASIC compiler to compile a source program. 


Format 
$BASIC[/switches|][specification field][/switch][specification fields] 
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Switches 


/BP1 
Uses the BASIC-PLUS compiler. The default is /BP1. The default file 
type is .BAS. 


/BP2 
Uses the BASIC-PLUS-2 compiler. The default is /BP1. The default file 
type is .B2S. 


/EXECUTE 
Creates an executable file. You can choose the file type according to the 
following rules: 


e If you use BASIC-PLUS, give the file a .BAC file type. 
¢ If you use BASIC-PLUS-2, give the file a .TSK file type. 


/NOEXECUTE 
Creates a temporary executable file, if one is needed, and deletes the 
file when $BASIC processing completes. 


/LIST 
Produces the listing file filename .LST. The default is /NOLIST. 


/NOLIST 
Does not produce a listing file. The default is /NOLIST. 


/MAP 

Creates the Task Builder map file filename .MAP. This switch causes 
BASIC-PLUS-2 to run; it also causes a Task Build operation. The 
default is /NOMAP. 


/NOMAP 
Does not create a map file. This switch causes BASIC-PLUS-2 to run. 
The default is /NOMAP. 


/OBJECT 
Creates the object file filename .OBJ. The /OBJECT switch causes the 
BASIC-PLUS-2 compiler to run; it also causes a Task Build operation. 


/NOOBJECT 
Creates the object file filename .TMP. This switch causes the BASIC- 
PLUS-2 compiler to run. 
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/RUN 

Executes a previously compiled and task built program. If you 
use /RUN, you can indicate only one file specification and only one 
switch: /EXECUTE. 


/NORUN 
Performs the compiled and task build procedure, but does not execute 
the final file. 


$COPY Command 
Copies files. 


Format 
$COPY filel/output file2/Anput 


Usage Notes 


You cannot use an asterisk (*) in file specifications with this command. 


Switches 


/INPUT 
Copies files. 


/OUTPUT 
Creates new files. 


$CREATE Command 
Creates an ASCII file in the specification field. 


Format 
$CREATE file 


Usage Notes 


The ASCII file you create must follow the $CREATE command. You 
must type $EOD as the last line of the ASCII file; otherwise, you 
receive an error message. When it encounters a dollar sign ($) in the 
first column of a line, $CREATE terminates. Therefore, do not specify 
any commands preceding the ASCII file you create. 
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$DATA Command 


Enters data to a program that is compiled and run by one of the 
language commands (for example, $BASIC). $DATA also makes sure 
that the program runs (unless you specify the /NORUN switch). 


Format 
$DATA 


Usage Notes 
$DATA is typed without specification fields or switches. 


$DELETE Command 
Deletes the files you specify. 


Format 
$DELETE file1.typ[file2.typ ...] 


Usage Notes 


You must include a file name and file type in the specification field. 
You cannot use an asterisk (*) in either the file name or file type field. 
$DELETE has no switches. 


$DIRECTORY Command 


Lists files in an account you specify. 


Format 
$DIRECTORY [specification field] 


Usage Notes 


You can include file specifications in the specification field. If you do 
not include any file specifications, $DIRECTORY lists the contents of 
the current account in the batch log file. You can use an asterisk (*) in 
either the file name or file type fields. 
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Switches 


{DIRECTORY 
Creates a directory listing in a disk file instead of the batch log device. 


INPUT 
Designates which files are to be listed. 


$DISMOUNT Command 


Cancels the logical to physical device assignment made by the 


$MOUNT command. 


Format 
$DISMOUNT [/switch] legical name: 


Switch 


/WAIT 
Holds the job until a response (as with the $MESSAGE command) is 
received from the operator. 


$EOD Command 


Marks the end of data records included in data you input after com- 
mands such as $BASIC, $CREATE, $DATA, and $RUN. 


Format 
$EOD 


$EOJ Command 


Marks the end of a job. The $EOJ command dismounts all devices 
mounted by the job and prints an appropriate message to the operator 
that the logical device should be dismounted. 

Format 


$EOJ 


Usage Notes 


When BATCH reaches the end of a control file (or another $JOB 
control statement) while processing a control file, the $EOJ command 
is implied. 
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$FORTRAN Command 

Calls the FORTRAN-IV compiler to compile a source program and 
generate an object program. 

Format 

$FORTRAN|/switches][specification field] 


Switches 


/LIBRARY 
Indicates a library file to link with the FORTRAN program. 


/LIST 
Produces the listing file filename .LST. The default is /NOLIST. 


/NOLIST 
Does not produce a listing file. The default is /NOLIST. 


/MAP 
Creates the map file filename .MAP. The default is /NOMAP. 


/NOMAP 
Does not create a map file. The default is /NOMAP. 


/OBJECT 
Creates the compiled file filename .OBJ. The default is /NOOBJECT. 


/NOOBJECT 
Does not create an object file. The default is /NOOBJECT. 


/RUN 
Executes the previously compiled file. You must specify an object file. 


/NORUN 
Compiles the source program, but does not execute the object file. 


$JOB Command 
Marks the beginning of a batch job. 


Format 
$JOB [/switches] [n,m] 
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Switches 


/CCL 

Uses the system’s interactive Concise Command Language (CCL). 

If you specify this switch, any of the system commands that do not 
conflict with existing BATCH commands can follow the dollar sign ($) 
character. 


/CPU=nn 

Assigns a CPU time limit to the job. The value of nn is a decimal 
number that is interpreted as seconds. If you specify /CPU without 
/LIMIT, no elapsed time limit is enforced, and the only time limit is on 
CPU time. If you specify /CPU and /LIMIT, both limits are enforced. 


/NOCPU 
Gives the job an unlimited amount of CPU time to complete. 


/DCL 

Disables all current BATCH commands that conflict with DCL com- 
mands and allows them to be processed by DCL. The job is spawned 
under the DCL run-time system. If you do not include this switch, the 
job is spawned under the RT11 run-time system. 


/ERROR=[operand] 

Specifies the level of error the batch processor accepts without ter- 
minating the job. The level is indicated by [operand], which can be 
FATAL, WARNING, or NONE. If FATAL, all errors are accepted until 
completion. If WARNING, a fatal error terminates the job, but warn- 
ing errors are accepted. If NONE, any error terminates the job. The 
default error level is determined at system start-up. 


/LIMIT=nn 

Assigns an elapsed time limit to the job. The value of nn is a decimal 
number that is interpreted as minutes. Note that the elapsed time 
taken to execute a job depends heavily on overall system loading. 


/NOLIMIT 

Gives the job an unlimited amount of elapsed time to complete. If you 
do not specify /LIMIT=nn or /NOLIMIT, the job is given ten minutes 
elapsed time to complete execution before BATCH terminates it. 
/NAME=job 

Assigns a name to the job. Job names can be one to six characters long. 
This name overrides the control file name as the identifier of the job. 
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/NONAME 
Indicates that no job name is defined. The system assigns a default job 
name, which is the name of the control file. 


/PRIORITY=n 

Sets the job priority to n (or the next lowest multiple of 8) for batch 
processing. If you are privileged, n can be between -120 and +127. If 
you are nonprivileged, n is limited to a value between -120 and -8. The 
default is -8. 


/QUE 
Queues the batch log file to LPO: (the default) or the device specified at 
system start-up. 


/NOQUE 
Suppresses printing of the batch log file. 


$MESSAGE Command 


Logs a message on the operator services console. 


Format 
$MESSAGE[/switch] message-string 


Switch 


/WAIT 

Makes the program pause to wait for operator action. This condition 
stays in effect until the operator responds to the message on the 
operator services console. See the RSTS/E System Manager’s Guide 
for information on response procedures. 


$MOUNT Command 
Causes a logical to physical device assignment. 


Format 
$MOUNT devn:[/switch] devm:[/switch] 
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Usage Notes 


You must specify both the logical and physical devices. The physical 
device refers to the physical device type. Enter the device and unit 
number in the standard format (for example, MT1:). You can specify 
logical device names that have one to six characters. Use the colon (:) 
as the terminator for each device specification. 


Physical Device Switches 


/DENSITY:nn 
Specifies density for magnetic tape. 


/PARITY:[ODD] 
[EVEN] 
Specifies odd or even parity for magnetic tape. 


/PHYSICAL 
Identifies the device specification as the physical device. This is the 
default. 


/VID:[string] 
Identifies the volume for the operator. 


/WRITE 


Tells the operator to write-enable the device or volume. 


/NOWRITE 
Tells the operator to write-protect the volume. 


Logical Device Switch 


/LOGICAL 
Identifies the device specification as the logical device name. This 
specification must correspond to the pack-id label for RSTS/E disks. 


$PRINT Command 
Prints the contents of files on the line printer. 


Format 
$PRINT filel.typ/switches [file2.typ...] 
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Usage Notes 


You can use the switches available with the QUE system program for 
all file specifications. See the QUE command for a description of the 
switches. You can use an asterisk (*) in file specifications. 

$RUN Command 


Executes system programs. 


Format 
$RUN [file.typ] 


Usage Notes 


The file specifies the executable program. If you omit the file, the 
system runs the current program. 


$SORT Command 


Executes the SORT-11 program that is supplied on RSTS/E systems. 
See the PDP-11 SORT /MERGE User’s Guide for more information on 
SORT-11. 


Format 
$SORT [/switches] [output [/OUTPUT]] [input [/INPUT]] [spec/SPEC] 


Usage Notes 


You can abbreviate job switches to the first three letters. If you specify 
more than one switch, separate them with slashes (/). 


If you specify /SPECIFICATION, you cannot use the /KEYS and 
/PROCESS switches in the command line. However, if you do not 
use a specification file in the control statement, you must include the 
/KEYS switch in the command field to control the sorting process. 


You must always include the /FORMAT switch in the command field. A 
file specification without a switch is used as the file to be sorted. If you 
omit the file type in the file specification, the default is .SRT. 
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Switches 


/ALLOCATION:n 

Allocates space for an output file. The value n can range from 0 to 
65535 blocks. If you do not specify the allocation, the default depends 
on the sort process (see /PROCESS). If /PROCESS is Record or Tag, the 
default is the input file size. If /PROCESS is Index or Address Routing, 
the default is the number of records sorted. 


/BLOCKSIZE:n 

Specifies the tape block size for input or output. The default is a 
512-byte block. 

/BUCKETSIZE:n 


Specifies the file’s bucket size for output. The default is the bucket size 
of the input file. 


/CONTIGUOUS 
Specifies a contiguous file for output. The default is noncontiguous. 


/DEVICE:x 
Specifies the device used for scratch files for input. The value of x is a 
one- to four-character device name. 


/FILES:n 
Specifies the number of scratch files for input. The value n can range 
from three to ten. 


/FORMAT:x:n 

Specifies the file’s record format (x) and maximum record size (n) for in- 
put. The value x can be FIXED, STREAM, VARIABLE, or UNKNOWN 
and can be abbreviated to the first letter. You must specify this switch 

and the record size if you use $SORT. The default format is VARIABLE. 


/INDEXED_SEQUENTIAL:x] 
Specifies indexed file organization for input. The value x specifies the 
number of keys. 


/KEYS:abm.n 

Specifies the sorting key field for input. You must specify this switch 
if you do not include a specification file in the command line. You can 
specify a maximum of ten keys separated by colons. For example: 


/KEY:abm.n:abm.n:...abm.n 
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/PROCESS:x 

Specifies the sorting process for input. The value x can be Record 
sort (the default), Tag sort, Address Routing, or Index sort. You can 
abbreviate each process to the first letter. 


/RELATIVE 
Specifies relative file organization for output. 


/SEQUENTIAL 
Specifies sequential file organization for output. 


/SIZE:n 
Specifies the file’s cluster size for output. 


You can specify up to three file specifications (separated by spaces) 
in the $SORT control statement: an input file, an output file, and a 
specification file. Use the following switches to distinguish these files 
(they can be abbreviated to the first three letters): 


/INPUT 
Specifies the file to be sorted. 


/OUTPUT 
Specifies the file containing the sorted data. 


/SPECIFICATION 
Specifies the file containing the control information for the sorting 
process. 


QUE 


QUE submits requests to the OPSER-based spooling programs. QUE 
also lists pending requests, kills pending requests, and modifies pend- 
ing requests. 


Privilege Required 


° Read access to input files. 
¢ Write access to files specified using /DE (delete) 


¢ GACNT or WACNT privilege to submit requests under a PPN other 
than your own 


To Run the Program 


RUN OPSERS: QUE 
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Usage Notes 


You can use wildcard characters for the file name and type, but not for 
the PPN. 


QUE Program Commands 


Q 


Specifies one or more files you want to process. 


L 
Displays a list of the currently pending requests for the spooling 
program on your terminal. 


Ss 
Same as the L command, except that QUE displays a short form list. 


K 
Removes one or more jobs you indicate in the device specification and 
job name. 


M 
Modifies the parameters of a job already in the queue. 


F 
Directs QUE to abort all current jobs in the queue. 


H 


Displays an informational message on your terminal. 

E 

Terminates QUE and returns control to system command level. 
Q Command Output Switches 


/MO:n 
The value n specifies the MODE that the spooling program uses in its 
OPEN statement for the line printer. 


/LE:nnn 
Set forms length to nnn (1 to 127) lines per page. 


/CO 
Changes number 0 (zero) to letter O (oh). 


/TR 
Truncates lines longer than unit’s configured length. 
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/LP 
Enables software formatting. 


/UP 


Translates lowercase to uppercase characters. 


/SK 
Skips six lines at bottom of each form. 


/AF:spec 
Initiates the current request after the value given in spec. Spec can be 
one or more of the following: 


dd-mmm-yy 
H:mm 
yy.mm.dd 
H:mm:am/pm 
+n D[AYS] 
+n H[OURS] 


/PR:n 
QUE sets the priority to the value of n, which can be in the range 0 
and 255. The default priority is 128. 


/TY:xxx 
Uses the format specified by xxx for printing the file; xxx can be: 


FORTRAN forms control 
Embedded forms control 
Implied FORMS control 
LF and CR printed before each record 


/FO:form-name 

Form-name specifies the name of the form on which the job is printed; 
form-name cannot exceed six characters, and the first character cannot 
be a digit. 

/JC:n 

The value of n specifies is the number of job copies you want to print. 
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RESTOR 


Q Command File Name Switches 


/CO:n 
SPOOL prints the number of copies indicated by the decimal integer n. 
The default is one copy. 


/NH 
SPOOL suppresses printing of the file header. 


/DE 
SPOOL deletes the file after it is printed, if the protection code of the 
file permits. 


/MORE 
Indicates to QUE that you have more text to type on the next physical 
line. Used only at the end of a command line. 


/BI 
Indicates a binary file to the RJ2780 program, which must be in 
transparent mode. 


/RE 
SPOOL restarts the file or job if a malfunction occurs in printing. 


The RSTS/E RESTOR program lets you return files you backed up 
before RSTS/E V9.0 (using the BACKUP program) to online use. The 
RSTS/E V9.0 RESTOR utility includes the restore features previously 
included in the BACKUP utility. RESTOR provides three operational 
modes: 

¢ Restore, to rebuild Backup-created files onto a RSTS/E disk 


¢ Loadindex, to copy the primary index file from the last volume of 
the Backup Set to a RSTS/E formatted disk 


¢ List, to print directory information contained in a Backup index file 


Privilege Required 
To run RESTOR, you need WACNT, WREAD, and WWRITE privileges. 
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Table A-1: 


Question 


1 


la 


To Run the Program 
RUN RESTORS: RESTOR 


The dialogue begins when you run RESTOR. The first question asks 
which of the three operational modes (Restore, Loadindex, or List) you 
want to perform. If you choose, you may create an indirect command 
file. The dialogue then asks you where to create the work file into 
which it will write the directory and error information. Additional 
questions ask for information on which files and accounts to trans- 
fer. When the dialogue ends, the program writes a summary of your 
commands into the listing file. Table A-1, Table A—2, and Table A-3, 
summaries of the Restore, Loadindex, and List dialogues, follow. 


RESTOR Dialogue Summary 
Response and Meaning 
RES[TORE], LOA[DINDEX], or LIS[T]}?? 
RES[TORE] (/SA[VE]) 


Restores files. If you append /SA[VE], RESTOR creates an indirect command file 
and asks question la. 


INDIRECT FILE NAME<_SY:[(CUR ACTJRESTOR.CMD>? 

File specification 

Creates an indirect command file with the specified name. Valid output devices are 
disk and tape. Asked only if the SAVE switch is appended in question 1. 


WORK-FILE NAME<_SY:[(CUR ACT] Bddmmm.Jnn>? 

File specification 

Uses the specified file as the work file. If the default is accepted, RESTOR uses 
either Bddmmm or Bymmdd as the file name format. If the system date format, 
selected during installation, is alphabetic, the default name format is Bddmmm. 


where: 


dd Specifies the day of the month 
mmm Specifies the first three characters of the month 
If the system date format is numeric, Bymmdd is the default name format. 
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Table A-1 (Cont.): RESTOR Dialogue Summary 
Question Respense and Meaning 


where: 


y Specifies the last digit of the current year 
mm _ Specifies the number of the month 
dd Specifies the day of the month 


In the .Jnn file type, nn represents the job number RESTOR is running under. You 
can substitute any mounted, write-enabled disk for SY:. 


3 LISTING FILE<_KB:>? 
KBn: or LPn: 
Writes the listing file to the snecified keyboard or line printer unit. 
File specification 


Writes the listing file to the specified file on disk or tape. The default file name is 
SY: [CUR ACT] RESTOR.LST. 


4 INDEX FILE<PRIMARY>? 
File specification 
Uses the specified file as the index file. You can specify an auxiliary index file or an 


index file created during a Loadindex operation. If you accept the default, RESTOR 
uses the primary index file that is on the final volume of the Backup Set. 


5 FROM DEVICE<_MT:>? 
MT:, MM:, MS:, or disk name 


Restores backed-up files from the specified medium. (Do not specify a unit number 
here, only a device type. RESTOR requests the unit number later.) 


6 FROM FILE(S) <[CUR ACT}*.*>? 
BACKUP File specification(s) 


Restores the specified files. 


7 TO DISK<_SY;[*,*]>? 

Disk name 

Restores the specified files to the designated disk. 
8 BEGIN AT <[*,*]*.*>? 

BACKUP File specification 


Restores starting with the file specified here. The default starts with the first file 
matching the file specification in question 6. The answer must be a single file 
specification. No EXCEPT modifiers are allowed. 
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Table A-1 (Cont.): RESTOR Dialogue Summary 


Question 
9 
10 
11 
Table A-2: 
Question 
1 
la 


Response and Meaning 


ENTER ACCOUNTS<YES>? 

YES 

Creates, on the destination disk, all accounts on the Backup Set that do not already 
exist on the destination disk. 


NO 

Does not create any accounts. You cannot selectively create accounts. 
SUPERSEDE<NONE>? 

BACKUP File specification(s) 


Overwrites the specified files on the destination disk with the backup versions. 

If you accept the default, RESTOR does not supersede any files. (To supersede 
files, you must include a file specification. RESTOR does not supersede all files on 
the destination volume if you type ALL or YES. Instead of superseding the entire 
volume, RESTOR replaces only files that have a file specification of ALL or YES.) 


COMPARE FILE(S)<NONE>? 
BACKUP File specification(s) 


Compares the restored files to the backup versions after transfer. As in the 
SUPERSEDE question, you must provide a file specification here instead of an 
answer such as ALL or YES. 


LOADINDEX Dialogue Summary 
Response and Meaning 


RES[TORE], LOA[DINDEX], or LIS[T]? 

LOA[DINDEX]? 

Copies index file from the Backup Set to a RSTS/E formatted disk. If you attach 
/SA[VE] to the LOA[DINDEX] response, RESTOR creates an indirect command file 
and asks question la. 

INDIRECT FILE NAME <_SY:[(CUR ACTJLOADIN.CMD>? 

File specification 

Creates an indirect command file with the specified name. Valid output devices 
are disk and tape. This question is asked only if you use the /SA[VE] switch in 
response to question 1. 
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Table A-2 (Cont.): LOADINDEX Dialogue Summary 


Question 


2 


ie) 


Response and Meaning 


WORK-FILE NAME<_SY:[CUR ACT]Bddmmm.Jnn>? 

File specification 

Uses the specified file as the work file. If you accept the default, LOADINDEX uses 
either Bddmmm or Bymmdd as the file name format. 


where: 


dd Specifies the day of the month 

mmm _ Specifies the first three characters of the month 

y Specifies the last digit of the year 

mm Specifies the number of the month 

Tn the file type .Jnn, nn represents the job number RESTOR is running under. You 
can substitute any mounted, write-enabled disk for SY:. 

LISTING FILE<_KRB:>? 

KB: or LP: 

Writes the listing file to the keyboard or the line printer. If you press RETURN or 
LINE FEED, RESTOR sends the listing file to the keyboard <KB:>. 

File specification 


Writes the listing file to the specified disk or tape. If you type SY: and then 
press RETURN, the RESTOR program creates the default listing file [CUR 
ACTIJLOADIN.LST. 


FROM DEVICE<_MT:>? 

MT:, MM:, MS:, or Disk Name 

Copies the index file from the specified Backup Set device. 

TO FILE<_SY:[CUR ACT] [BINDdd.IND]? 

File specification 

Loads the Backup Set index file into the specified file. You can copy the index to a 


disk device only. The format for the default file name is BINDdd.IND, where dd is 
the numeric day of the month. 
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Table A-3: LIST Dialogue Summary 


Question Response and Meaning 


1 


la 


RES[TORE], LOA[DINDEX], or LIS[T]? 

LIS[TVSA[VE] 

Runs the LIST dialogue. When you attach the /SA[VE] switch to the LIST response, 
RESTOR creates a DCL command file after you respond to question la. 

INDIRECT FILE NAME<_SY:[CUR ACT][LIST .CMD]>? 

File specification 

Creates a DCL command file with the specified name. Question la appears only if 
you use the /SA[VE] switch in response to question 1. Valid output devices are disk 
and tape. 

WORK-FILE NAME<_SY:[CUR ACT]Bddmmm.Jnn>? 

File specification 


Uses the specified file as the work file. If you accept the default by pressing 
RETURN or LINE FEED, LIST uses either Bddmmm or Bymmdd as the file name 
format. 


where: 


dd Specifies the day of the month 
mmm Specifies the first three letters of the month 
mm Specifies the number of the month 


In the file type .Jnn, nn represents the job number RESTOR is running under. You 
can substitute any mounted, write-enabled disk for SY:. 


LISTING FILE<_KB:>? 
KB: or LP: 
Writes the backup directory information to the specified device. If you press 


RETURN or LINE FEED, the backup directory is written to your keyboard. Type 
LP: and press RETURN for a line printer listing. 


File specification 
Writes the backup directory information to the specified file. Type SY:, and press 


RETURN if you want RESTOR to create the default listing file, 
[CUR ACT]LIST.LST. 
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Table A-3 (Coni.): LIST Dialogue Summary 
Question Response and Meaning 


4 


INDEX FILE<PRIMARY>? 

File specification 

Extracts the index file from the specified file and writes it to the listing file. If you 
accept the default by pressing RETURN or LINE FEED, LIST requests the index 

volume. It then takes the directory information from the index volume and writes 
the information to the listing file. 


FROM DEVICE<_MT:>? 
File specification 
Asked only if you accept the default in the INDEX FILE<PRIMARY> question. The 


file specification response must identify the device on which the index resides. You 
can accept the magnetic tape default <_MT:> by pressing RETURN or LINE FEED. 


The LIST program begins a MOUNT dialogue, which asks you to mount the Backup 
Set index volume and identify the target device. 


File Specifications 


Several questions in the dialogue require you to respond with a file 
specification. The specification can include file name, account, and 
dates of creation and last access. In addition, you can specify one or 
more files as exceptions from a process. 


The file specification has the format: 


filename/keyword:comparison:date:time/exception (filename. . .) 
where: 

filename Is a standard RSTS/E file specification. 

keyword Is either CR[EATION] or AC[CESS] and specifies that RESTOR 


is to interpret the date and time as either file creation or access 
dates and times. 


comparison Is either BEF[ORE] or AFT[ER] and specifies that RESTOR is 
to process files created or accessed before or after the date and 
time. 


date Specifies the date RESTOR uses to process files. 
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time Optionally specifies the time RESTOR uses to process files only 
when you specify CREATION. Use the 24-hour format such as 
14:49. The default is 00:01 on the specified date. 


exception Is EXC[EPT] and specifies that RESTOR is to exclude from 
processing the specified files that follow. You can include all of 
the previous elements in an EXCEPT phrase but do not include 
another EXCEPT phrase. Separate multiple file specification 
commas and enclose the list in parentheses. 


RESTOR Interruption Commands 


The RESTOR package includes interruption commands for your con- 
venience. These commands enable you to detach, terminate, suspend, 
and continue processing and to check the status of the run. 


RESTOR shows it is ready to accept interruption commands by printing 
an asterisk on the job’s console terminal after the dialogue is complete. 
You can type an interruption command as a response to a request in 
the mount procedure or any time after the asterisk appears. Table A+4 
provides a summary of the interruption commands. 


Table A-4: RESTOR Interruption Commands 
Command and Meaning 


ABO[RT] 

Terminates processing immediately and returns control to your keyboard monitor. 
CON[TINUE] 

Continues processing after a PAUSE command. 
DET{ACH] 

Detaches job from KB:. RESTOR detaches if three conditions are met: 


¢ OPSER is running 
e ©The listing file is not on KB: 
¢ No messages are currently pending for this copy of RESTOR. 


RESTOR is given a receiver identification of BACKnn, where nn is its job number. All 
interaction with RESTOR is done through OPSER. 


END 


Terminates after processing the current file. 
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Table A—4 (Cont.): RESTOR Interruption Commands 
Command and Meaning 


LAS[T] 


Reprints, on KB:, the last text printed. If the program is awaiting a response, reprints 
the question or prompt. If not, reprints the last message. 


LEG{AL] 


Prints (on KB:) a list of the commands and responses that are legal now. In the list, 
**OTHER** means that a request for information from you is pending (for example, 
Backup Set name). The response to such a request is any appropriate string. You 


fin 


do not need to use quotation marks (") unless the response can be interpreted as an 
interruption command. For example, you can legally name the Backup Set PAUSE, but 
you must type the name in quotes ("PAUSE") 


NOT[ICE] 
Writes the specified text in the listing file. The NOTICE command has the format: 
NOT{ICE] message 
Message represents one line of text. No line terminators are allowed in the message. 
OFF[LINE] 
Same function as ABORT. 
PAU[SE] 


Suspends execution until you type CONTINUE. Any legal command typed during a 
PAUSE is executed immediately. 


STA[TUS] 
Prints, on KB:, RESTOR status information. 
TER[MINATE] 


Closes the current volume at the end of the current file or at the end of the current 
output volume, whichever comes first. 
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Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 
before placing your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using 
a 1200- or 2400-baud modem. If you need assistance using the Electronic Store, 
call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location Call Contact 
Continental USA, 800-DIGITAL Digital Equipment Corporation 
Alaska, or Hawaii PO. Box CS2008 

Nashua, New Hampshire 03061 
Puerto Rico 809-754-7575 Local Digital subsidiary 
Canada 800-267-6215 Digital Equipment of Canada 


Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 


International —_—_— Local Digital subsidiary or 
approved distributor 

Internal? — USASSB Order Processing - WMO/E15 
or 


U.S. Area Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


1For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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Please use this postage-paid form to comment on this manual. If you require a written 
reply to a software problem and are eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR form. 


Thank you for your assistance. 
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